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TAFT  I USSR  FEOUIFF.KENTS  ANALYZE? 

The  qoal  of  Tart  I is  to  assist  the  User  Requirements  Analyzer 
(UFA)  user  in  effectively  using  the  URA  Modifier  Commands 
specified  in  Part  IV,  "User  Requirements  Analyzer  Command 
Descriptions, '•  This  paper  illustrates  the  usage  of  Version  3.3 
of  the  User  Requirement s Analyzer  and  specifies  the  steps  in 
creating  the  UFA  data  base,  inputting  User  Requirements  Language 
(URL)  statements,  modifying  the  contents  of  the  data  base, 
generating  UFA  outputs,  and  correcting  syntactical  and  logical 
errors. 

Since  UFA  is  used  in  con-junction  with  an  operating  system,  this 
part  should  be  used  in  conjunction  with  Part  II  which  presents 
installation  dependent  features  to  be  considered  when  usinq  UFA. 
This  part  covers  installation  independent  features  of  UFA, 
general  concepts,  etc.  Each  section  of  this  part  has  a 
corresponding  section  in  Part  II.  This  allows  easy  reference 
between  general  concepts  arid  the  actual  practice  of  applying 
them  in  a particular  installation. 


PA  FT  II  USAGE  OF  THE  USER  FEOUIFEMENTS  ANALYZER  UNDEF  HULTICS 

The  purpose  ot  Part  II  is  to  assist,  the  UFA  user  in  effectively 
manipulating  tne  UFA  command  language  under  Multics.  This  paper 
covers  those  installation  dependent,  features  of  UFA  and  is 
intended  to  be  used  in  conjunction  with  the  User  Requirements 
Analyzer,  Part  I.  Each  section  of  this  Part  has  a corresponding 
section  in  the  user  Requirements  Analyzer.  This  Part 
illustrates  the  usage  of  Version  3.3  of  the  User  Requirements 
Analyzer. 


PAFT  III  UFA  OUTPUTS 

The  goals  of  Part  TII  are  to  assist  the  User  Peuuirements 
Analyzer  user  in  generating  reports  from  the  information  in  a 
UFA  data  base,  describe  the  standard  reports  available  in  URA, 
and  tinally,  provide  general  guidelines  on  usinq  these  repots 
to  aid  in  the  logical  system  design  process.  In  order  to 
generate  the  reports  described  in  this  paper  it  is  necessary  to 
understand  the  intormation  presented  in  Part  I and  Part  II  for 
the  installation  in  which  UFA  is  being  used.  It  is  also 
desirable  to  use  the  "User  Requirements  Analyzer  Commands 
Descriptions,"  Part  IV  as  a reference  for  a bettor  understanding 
ot  the  URA  commands  and  parameters  used  to  generate  a particular 
report . 

This  part  describes  those  UFA  reports  available  in  Version  3.3 
of  the  User  Fuqu irement s Analyzer. 
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PART  IV  USSP  REQUIREMENTS  AN ALY7FP  COMMAND  DESCRIPTIONS 

The  oblective  of  Part  IV  is  to  give  the  user  of  the  User 
Requirements  Analyzer  (UFA)  the  list  of  the  commands  available, 
the  correct  syntax  of  these  commands,  and  the  parameters 
allowable  for  each  command.  This  part  is  not  intended  as  a 
handbook  on  how  to  use  URA,  but  rather  as  a reference  for  the 
commands  available.  Part  I and  Part  II  describe  how  to  use 
these  commands  and  present  a detailed  description  of  each  of  the 
outputs  generated  by  these  commands.  This  paper  describes  the 
facilities  of  Version  3.3  of  the  User  Requirements  Analyzer. 

The  manner  in  which  URA  directly  interlaces  with  a particular 
operating  system  is  given  in  Appendix  t.  Also  included  in  this 
Appendix  is  a formal  description  of  the  UFA  commands  available 
only  under  that  particular  opera*-  irg  system. 


PART  V AUTOMATED  DOCUMENTATION  SYSTEM  USER*S  MANUAL 

The  objective  of  Part  v is  to  provide  derailed  operating 
instructions  for  the  Automated  Documentation  System  (ADS).  ADS 
is  a stand-alone  program  and  file  structure  that  operates  on  a 
URL  data  base  to  produce  requirements  specifications  in  standard 
formats  (e.q.,  MIL  STD  483). 
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1.  INTRODUCTION 


The  first  step  in  use  ot  the  URL/UFA  system  consists  of 
specify  inq  a probltam  statement  in  URL  statements.  The  second 
step  consists  of  using  U^A  to  enter  the  problem  statement  into  a 
computer  data  base,  USA  extracts  information  from  the  URL 
statements  and  stores  it  in  a UFA  data  base.  Once  this 
information  (a  problem  statement)  is  in  the  data  base,  it  can  be 
modified,  new  information  can  be  added  to  it,  and  reports 
present  inq  the  status  of  the  problem  statement  can  be  generated. 
These  actions  are  implemented  by  the  UFA  commands  available  in 
the  UFA  processing  mode.  This  mode  ot  operation  may  be  attained 
by  accessing  the  UFA  software  available  on  a particular 
operating  system.  Therefore,  by  understanding  the  operatinq 
commands  that  interact  with  UFA  and  tho  URA  command  language, 
the  problem  detiner  (user)  can  effectively  manipulate  the 
contents  of  a URA  data  base.  Part  I,  of  this  manual,  serves  as 
a guide  to  using  the  UFA  commands. 

Operating  system  and  URA  commands  can  only  be  used  in  their 
respective  processing  modes.  Operating  System  commands  can  be 
used  from  time  of  signing  on  to  the  system,  to  the  time  access 
to  the  URA  software  is  acquired.  At  this  point,  only  UFA 
commands  may  be  used  until  tho  problem  definer  returns  control 
to  the  operating  system  or  terminates  processing  to  be  done  in 
UFA  mode  (through  use  ot  the  UFA  "STOP"  command).  Operating 
system  commands  then  can  again  be  used  up  to  the  time  of  signing 
off.  This  interaction  between  operating  system  and  URA  modes  is 
illustrated  by  Figure  1.  An  exception  to  this  rule  is  the  UFA 
command  "MTS"  which  allows  one  to  execute  an  operating  system 
command  while  in  URA  mode. 

The  first  five  sections  ot  Part  I deal  with  UFA  at  an 
introductory  level.  Section  2 presents  introductory  information 
about  the  use  of  URA.  Section  3 explains  the  procedure  of 
initializing  UFA  once  on  the  operating  system.  Sections  4 and  5 
present  practical  concepts  and  conventions  to  be  known  before 
using  UFA.  (Once  access  to  UFA  has  been  achieved,  various 
commands  are  available;  these  commands  are  described  in  Section 
6,  7 and  ft.)  Several  examples  are  given  in  these  sections  in 
order  to  better  illustrate  the  results  of  specific 
implementations . Sections  9 and  10  deal  with  handling  errors 
encountered  in  the  use  of  UFA.  Appendix  A presents  a list  of 
all  UPA  commands  available  (and  the  parameters  for  each  command) 
as  well  as  the  abbreviations  for  all  these  to  serve  as  a quick 
reference.  Throughout  Part  I the  long  forms  of  URA  commands  and 
parameters  are  used  interchangeably  with  their  abbreviations. 
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OPERATING  SYSTEM  COMMAND 
LANGUAGE  MODE 


^ / Operating  System  Commands 


URA  MODE 


URA  Commands 


OPERATING  SYSTEM  COMMAND 
LANGUAGE.  MODE 


I 

j ^ Operating  System  Commands 

I 

i' 


SIGN  OFF 
OF.  SYSTEM 


Figure  l:  Interaction  between  Operating  System  and  URA 
processing  modes 
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2.  USIN(;  UFA 


2.1  It}?  UFA  Command  Lane]  ua  j e 

The  UFA  Command  Lanquuqe  commands  may  be  grouped  into  three 
major  types. 


Control  Com  man  is 

Control  Commands  are  u^ed  to  pass  certain  control  information  to 
the  User  Requirements  Analyzer.  These  commands  are  operatinq 
system  dependent  and  are  given  in  Part  II  of  this  manual.  The 
use  of  these  commands  does  not  chanqe  the  contents  of  the  data 
base. 

!1 

Modifier  Commands 

Modifier  Commands  aie  used  to  modify  the  contents  of  the  UFA 
data  base  in  the  manner  lefined  bv  the  problem  definer.  These 
commands  take  legal  URL  statements  or  URL  names  as  input.  UFA 
then  generates  error  diagnostics  as  well  as  an  output  report  to 
present  the  outcome  of  the  data  base  alteration. 


Report  Commands 

Report  Commands  retrieve  data  from  the  UFA  data  base  and  output 
it  in  some  standard  format.  These  reports  do  not  change  the 
contents  of  the  data  base  whatsoever.  Their  purpose  is  solely 
that  of  iisplaying  some  or  all  of  the  contents  of  the  data  base. 


2. 2 Command  Parameters 

Most  UFA  commands  have  parameters  which  may  be  set  by  the  user 
to  modify  the  actions  of  the  command.  There  are  basically  five 
types  of  parameters: 

Input  data  parameters  - these  parameters  specify  the  data  to  be 
used  as  inpu*-  to  the  command.  INPUT,  FILF  and  NAME  are 
examples  of  Input  data  parameters. 

Input  control  parameters  - these  parameters  specify  how  the 

input  data  is  to  be  used,  chanqed,  etc.,  by  tne  command. 
The  TYPE  parameter  for  the  CHANGF-TYPF  command  and 
CONTAINED/CONSIST;;  oarame*er  for  the  CCNSISTS-MATFIX 
command  are  examples  of  this  type. 


J 
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Output  flats  parameters  - these  parameters  specify  it  output  is 
to  be  generated  from  the  command  and  the  form  in  which  it 
is  presented.  The  PUNCH  and  PFIN?  parameters  are  examples 
of  this  type  of  parameter. 

Output  option  parameters  - these  parameters  specify  options 
which  may  be  included  or  omitted  from  the  output.  The 
LEVELS  parameter  for  the  CONTENTS  command  and  the 
DESCRIPTION  parameter  for  the  DICTIONAFY  command  are 
examples  of  this  type. 

Output  format  parameters  - these  parameters  specify  alternate 
formats  for  presontinq  the  information  in  the  output  from 
the  command.  The  NEW-PAGE  parameter  and  HMAFG  parameter 
for  the  FPS  command  are  examples  of  this  type. 


2 . 3 Sequence  of  Commands 

Althouqh  all  of  the  commands  can  be  issued  independently  of  each 
other,  it  is  often  advantageous  to  use  some  commands  in  sequence 
since  the  output  of  one  command  may  be  used  as  input  by  another. 
The  most  common  instance  of  this  is  when  NAKS-GEN  is  used  to 
select  certain  names  (say  all  PFOCESSES  for  example)  which  can 
then  be  used  as  input  to  a Report  Command  (possibly  PICTURE,  for 
a PICTURE  REPORT  for  all  PROCESS  names) . Though  NAK E-GEN  is 
technically  classified  as  a Report  Command  one  of  its  ma-jor 
functions  is  to  selectively  retrieve  names  scored  in  the  data 
base.  PUNCH-COKE ENT-ENTFY  and  FFPLACE-COKMENT- ENTRY  often  occur 
in  sequence.  For  more  information  about  use  of  these  commands, 
see  "UFA  Outputs"*  and  "UFA  Command  Pesr ipt ions . "* 


2. 4 Tfte  HELP  Cpmmand 

The  HELP  Command  provides  the  user  with  information  about  the 
syntax  and  parameters  of  UFA  commands.  The  HELP  command  does 
not  affect  the  manner  in  which  UFA  operates  nor  accesses 
information  in  the  data  base.  For  *his  reason,  it  is  not 
classified  as  a Control,  Modifier  or  report  Command.  When  the 
HELP  command  is  qiven,  UFA  displays  a list  of  all  available  UFA 
commands  and  their  abbreviations.  Fy  specifying  a particular 
UFA  command  name  as  a parameter  to  the  HELP  command: 

HELP  CONSENTS 

for  example,  all  the  parameters  available  for  this  command  will 
be  printed.  If  the  "LONG"  parameter  vert  given  in  con-junction 
with  a command  name: 


» Part  III 
* Part  IV 
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HI  LP  FPS  LONG 

all  parameters  tor  the  FORE  A TTED- PRO DLL K- STATEMENT  command  would 
be  printed  out  as  well  as  a description  of  the  function  of  each 
of  these  parameters  tor  the  command.  This  description  is 
presented  in  the  same  format  as  that  in  "User  Requirements 
Analyzer  Command  Descriptions,"*  To  illustrate  an  example,  when 
"HELP  CONTENTS"  was  given  the  following  information  was  printed: 


CONTENTS 

Prototype:  CONTENTS (CON T)  [parameter]  ... 
Parameters : 


FlLEf  = f dname  ],  NAME  (N)  =user  name 

INDEX,  NOINDEX 

LEVELS  = intecjer,  LE  VFLS  = ALL 

NC  FLAG , NONCFLAG 

PF I NT- SECURITY- IN FORMATION  ( PSI > 


Default : 
Default : 
Defau It : 
Default : 
Default: 


NOPFINT-SECUFITY- INFORMATION  (NPSI) 


FILE 

NOINDEX 

ALL 

NONCFLAG 

PFINT-SECUFITY- 

INFOFMATION 


3.  THE  UFA  ENVIRON  EE  NT 


The  considerations  necessary  for  using  UFA  and  preparing  for 
using  UFA  define  the  URA  environment.  The  following  points  must 
be  considered: 


- How  the  data  base  is  prepared. 

- How  UFA  is  executed. 

- How  UFA  is  used. 

- How  batch  use  of  UFA  is  different  from  terminal  use. 

The  first  three  points  are  presented  in  section  3,1,  "Initiating 
UFA,"  and  the  last  point  is  presented  in  section  3.2,  "Batch 
Versus  on-line  Use  of  UFA." 
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3. 1 Initiating  UFA 

The  steps  required  to  prepare  a UFA  data  base  for  access  by  UFA 
are: 


i)  The  UFA  data  base  file  must  be  created. 


Creation  of  the  data  base  file  occurs  only  once.  Once 
created,  any  changes  to  be  made  (including  emptying  the 
whole  file)  can  be  made  withcu*-  destroying  it. 

ii)  The  data  base  must  then  be  initialized  in  order  to  be 
accessed  by  UFA. 


Initialization,  for  the  most  part,  occurs  only  once,  at.  the 
time  of  creating  the  data  base.  The  data  base  must  be 
reinitialized  if  emptied. 


Executing  UFA  involves  running  the  UFA  program.  This  allows  the 
user  to  specify  UFA  commands  to  change  the  contents  of  the  data 
base  or  generate  reports  about  its  contents. 


Once  the  UFA  program  has  been  invoked  the  following  steps  are 
suggested  in  using  UFA: 


i)  The  data  base  to  be  accessed  bv  ♦'he  UFA  commands  must  be 
specified. 


This  should  be  done  any  time  UFA  is  used 
user  is  accessing  the  correct  data  base, 
data  base  to  be  used  will  set-  by  default 
executes  UFA.  Even  if  this  is  the  case, 
aware  that  the  default  is  in  effect. 


to  ensure  that  the 
In  some  cases  the 
any  time  the  user 
the  user  should  be 


ii)  UFA  commands  are  given  to  modify,  update  and/or  qenerate 
reports  on  the  data  base  information. 


Any  of  the  commands  given  in  "User  Requirements  Analyzer 
Command  Descriptions"1  can  be  issued  to  accomplish  these 
tasks.  The  order  in  which  commands  are  given  is  determined 
by  the  user. 


iii)  The  STOP  command  is  given  to  terminate  the  UFA  session. 
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3 . 2 Patch  Versus  Cn-_1  i_ne  Use  of  UR  A 

The  manner  in  which  a user  interacts  with  UFA  via  batch 
processinq  differs  from  on-line  (terminal)  usage.  There  are 
various  advantages  and  disadvantages  to  either  approach.  A tew 
of  these  are  given  in  Table  I. 

The  procedures  given  in  section  3.1  are  the  same  for  both 
on-line  and  batch  use  of  UFA.  The  specific  manner  in  which  UFA 
commands  are  given  by  the  user,  however,  is  different. 

In  batch  processing  of  UFA  commands,  UFA  commands  are  given,  one 
per  card,  following  the  card  which  executes  the  UFA  program. 

Any  errors  detected  in  specifying  the  command  (or  its 
parameters)  cause  the  command  to  he  ignored,  and  UFA  then  moves 
to  the  next  command. 

When  executing  UFA  in  on-line  mode,  the  user  must  wait  for  the 
message: 

SNTEF  COMMAND  (AND  ANY  PARAMETERS) 

before  giving  any  commands.  After  fyping  in  the  command 
followed  by  a carriage  return,  the  user  must  wait  again  until 
the  command  prompting  message  is  issued  before  entering  the  next 
command.  If  an  error  occurs  when  specifying  the  command  (or  its 
parameters)  the  user  will  be  prompted  for  a replacement. 
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On-line  Use  of  UFA 


ADVANTAGE 

The  user  is  able  to  handle  errors  as  they  occur.  Errors 
can  be  corrected  before  any  attempt  is  made  to  modify  or 
retrieve  information  in  the  data  base. 


Which  UFA 
are  given 
may  issue 


commands 
does  not 
commands 


to  be  issued  and  the  order  in  which 
have  to  bo  predetermined , i.e.,  the 
ad  hoc. 


they 

user 


Utilizing  the  edit  facility 
the  user  to  make  changes  to 
quickly  and  efficiently. 


of  the  operating  system  allows 
information  in  the  data  base 


DISADVANTAGES 


Loss  of  connection  between  terminal  and  computer 
hits)  may  cause  the  contents  of  the  data  base  to 
unusable.  Recovery  procedures  would  be  required 
the  data  base  contents. 


(line 
become 
to  restore 


On-line  use  is  generally  more  expensive  than  batch  because 
of  connect  time  costs  and  other  additional  costs  related  to 
terminal  access. 


Table  1. 

Comparison  of  ON-Line  Versus  Batch  Use  of  UFA 


Part  I User  requirements  Analyzer 


UFA  User's  Manual  10 


t ch  Use  of  U.F  A 
ADVANTAGE? 

Requires  the  UFA  user  to  think  out  procedures  (list  of  UFA 
commands)  to  be  executed  before  they  are  executed. 

Cheaper  to  run  than  on-line  use. 

All  output  generated  by  URA  is  nrinted  in  a usable  format, 
i.e.,  via  the  line  printer.  Output  generated  at  the 
terminal  may  be  part  of  the  terminal  listing  and 
interspersed  with  other  information. 


DISADVANTAGES 

7urn-around  time  for  -jobs  may  be  long. 

Editing  of  information  in  the  data  base  may  require  two 
batch  runs;  one  to  retrieve,  one  to  replace. 

Errors  are  ignore!  and  any  subsequent  UFA  commands  would  be 
run  regardless. 

Table  1.  Continued 


4.  SPECIFYING  INPUT  TO  UFA  COMMANDS 


For  most  UFA  commands,  one  or  more  names  (specified  by  the  user) 
can  be  used  as  "input"  to  the  command.  This  can  be  done  by 
utilizing  t.he  "input  data"  parameters  for  the  command.  In  the 
case  of  Modifier  Commands,  the  modification  is  made  for  each 
name  used  as  input.  For  Report  Commands,  information  is 
retrieved  for  each  of  the  names  used  as  input.  Fxcept  for  the 
INPUT-P5L  command,  all  names  used  as  input  to  the  Modifier  and 
Report.  Commands  must  be  names  already  stored  in  the  problem 
definer's  UFA  data  base. 


4. 1 The  NAME  Parameter 

There  are  two  methods  of  specifying  names  to  be  input  to  a 
command.  The  simplest  way  is  to  use  the  NAME  parameter.  When 
this  parameter  is  used,  the  modification  will  be  nade,  or  a 
report  will  be  generated,  for  only  ♦■hat  name  specified  by  the 
NAME  parameter.  For  example,  if  NAMF=T-CARD  were  used  for  the 
DELETE  command,  only  T-CARP  would  te  deleted  from  the  data  base. 
Likewise,  if  NAME =7- CAFD  were  used  as  a parameter  tor  the 
CONTENTS  command,  the  CONTENTS  FEPOFT  would  be  generated  for  the 
name  T-CAFD,  and  no  others. 
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4.  2 The  FILE  and  INPUT  Parameters 


The  second 
put  all  the 
report  qene 
that  file  a 
specif icati 
parameters, 
next.  (See 
names  can  b 
parameters, 
specified  f 
the  file  an 
files  speci 
UPA  command 
used  as  inD 
URL  stateme 
Modifier  Co 
format  need 
of  each  com 

If  one  part 
session  to 
interact  wi 
the  file  be 
Otherwise 
be  leftover 


way  to  specify  names  as  input  to  a UPA  command  is  to 
names  for  which  the  modification  is  to  be  made,  or  a 
rated,  info  a file  and  specify  that  the  contents  of 
re  to  be  used  as  input.  At  most  installations  this 
on  can  simply  be  done  via  the  FILE  and  INTUT 


but  varies 
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The  manner  in  which  data  is  entered  into  a file  is 
installation-dependent.  Fee  Part  IT,  Section  4,  for  the  details 
of  this  procedure. 


4.  4 Usipq  NAME-GEN 

One  alternative  to  specifying  input,  to  Modifier  and  Report 
Commands  is  to  let  NAKE-GtN  uenerate  the  input  file.  The 
various  parameters  for  NAMt-GFN  allow  selection  of  particular 
types  of  names  that  are  desired  {e.q.,  all  GPOUPS  and  ENTITIES) 
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ENTITY  and  GROUP  names  in  the  UFA  data  base.  In  addition,  the 
contents  of  the  file  produced  by  NAME-GEN  are  maintained  until 
the  next  NAME-GFN  is  issued. 

|| 

4.5  Using  punch  files 

PUNCH  files  are  files  which  have  formats  acceptable  by  FILF  or 
INPUT  parameters.  The  file  described  in  the  previous  section  is 
a PUNCH  file  from  the  NAME-GIN  command.  Output  from  NAHE-GEN  is 
put  into  its  assigned  PUNCH  file  so  that  it  may  be  used  as  input 
to  any  of  the  FILE  parameters  for  Modifier  and  Report  Commands. 

The  PUNCH  file  format  is  different  from  the  report  format  for 
the  command  that  generates  both  of  them.  For  example,  upon 
execution  of  the  NAME-GEN  command  for  all  PROCESSES,  the  report 
generated  will  consist  of  a report  heading,  line  numbers  for  the 
contents  of  the  report,  the  names  of  all  PROCESSES  in  the  data 
base  and  their  corresponding  name  type  (which  is,  of  course, 

PROCESS).  The  contents  of  the  PUNCH  file  produced  by  this 
command  will  only  contain  the  names  of  the  PROCESSES,  without 
report  headings,  etc.  In  other  words,  the  PUNCH  file  contains 
similar  information  to  the  report  output  from  the  command,  but 
in  a format  acceotable  to  the  FILE  and  INPUT  parameters  of  other 
URA  commands. 

At  most  installations,  the  PUNCH  file  to  be  used  (name  of  the 
file)  can  be  specified  by  the  PUNCH  parameter  for  the  command. 

The  manner  of  assignment  varies  slightly  from  one  installation 
to  the  next.  (See  Part  II,  Section  4.)  Specific  usage  of  the 
PUNCH  parameter  is  given  in  the  descriptions  of  the  individual 
commands  that  utilize  this  parameter.  The  specific  names  of  the 
PUNCH  files  used  can  be  found  in  the  appropriate  Addendum  for 
Appendix  E, 


5.  RECEIVING  OUTPUT  FROM  URA  COMMANDS 


Several  UFA  commands  allow  the  user  to  specify  whether  output  is 
generated  from  the  command  or  not,1  This  is  done  via  the  "output 
data"  parameters  for  the  particular  command.  When  generating 
outputs  from  UFA,  the  information  is  put  into  a file  or  printed 
on  a device  such  as  a line  printer  or  terminal.  If  this  file  or 
device  is  not  specified  then  all  outputs  are  written  to  the  main 
output  tile  or  device.  This  means  that  output  will  be  written 
on  the  terminal  when  in  conversational  mode  and  on  the  line 
printer  when  running  batch.  There  are  several  reasons  why 


i This  section  only  deals  with  receiving  outputs  in  the  form  of 
reports  (as  specified  in  Part  III).  Receiving  output  as 
presented  via  the  PUNCH  parameter  is  discussed  in  the  previous 
section . 
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outputs  might  he  routed  elsewhere,  oxpecially  for  on-lire 
processing : 

- Large  quantities  of  output  would  Mko  too  lonq  to  he  printed 
at  the  terminal. 


- Depending  on  the 
may  not  be  printed 
the  terminal. 


type  of  terminal,  some  portions  of  the  output 
because  of  physical  restrictions  imposed  by 


- The  handling  of  printout  from  the  terminal  can  sometimes  be 
awkward  and  the  format  not  aesthetically  pleasing. 


- No  copy  of  the  output  is  desired.  (Only  the  punch  file  may  be 
needed  as  a step  in  a modification  procedure.) 

Most  methods  of  receiving  and  controlling  output  from  UFA 
commands  are  installation  dependent  and  therefore  given  in  Part 
II,  Section  5. 


5.1  Its  &Q2£in  £a£M£ier 


Several  UFA  commands  allow  the  option  of  not  havinq  the  output 
printed  via  the  NOTFINT  parameter.  The  commands  that  allow  this 
parameter  are: 


DELETE- CONK  ENT- FN  TF Y (DCOM) 

FOFHATTED-PFOPLEM- STATEMENT  (FPS) 

LIST-CHANGES  (LC) 

NAME-GEN  (NG) 

PRI NT-COMMENT-ENTF Y (PCCM) 

PROCESS- INPUT-OUTPUT  (PFIO) 

REPLACE-COMM  ENT-ENTFY  (FCOK) 

The  two  Modifier  Commands,  FCOM  and  DCOM#  have  this  parameter 
available  because  the  printout  can  be  fairly  large  and  may  not 
be  needed  for  future  reference.  The  report  headinq  for  the  FCOM 
or  DCOM  output  and  any  error  diagnostics  arc  still  printed  to 
provide  a hard-copy  record  of  the  command  execution. 

The  remaining  four  Fenort  Commands  can  use  this  parameter  in 
conjunction  with  the  PUNCH  parameter.  The  option  of  the  NOPFINT 
parameter  is  provided  because  wh^n  TUNCH  information  is  desired, 
there  may  be  no  need  for  the  printout. 
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5.  - Iil*l  P-\i.ain1_toi 

Several  commands  allow  the  user  to  specify  that  an  index 
(alphabetic  listing  of  names  used)  for  the  report  he  generated 
by  the  command.  The  index  also  specifies  the  pages  on  which 
these  nates  occur  in  ♦he  Leport.  This  is  done  by  specifying 
INDEX  a.,  a parameter  tor  the  command.  The  commands  which  allow 
this  parameter  are: 

CONTENTS 

DICTIONARY 

SXTENDKP-PICTUKF 

FOFM  ATT  ED- PROP  LEM-  ST  AT  KM  ENT 

FREQUENCY 

INTERVAL- CONSISTENCY 
PICTURE 
PROCESS-CHAIN 
PROCESS- INPUT-OUTPUT 
PROJECT  ED-COST 

RESOURCE-CON  SUMPTION- ANALYSIS 

SECURITY- ANALYSIS 

STRUCTURE 


S.  3 I]je  liOSOU£Ci  and  XREF  raramet  ors 

The  NOSOUFC K and  XFRF  parameter  have  the  same  function  for  the 
IN PUT-PSL  ind  DELETl-PSL  commands  as  the  NOPRINT  and  INDEX 
parameter  for  other  UFA  commands.  The  report  produced  by  XREF , 
however,  (the  UFA  CROSS  REFERENCE  LISTING)  specifies  the  lines 
rather  than  the  pages  where  the  names  occur. 


b.  CONTROL  CO MEAN OS 


All  control  commands  are  installation-dependent.  For  this 
reason  all  control  commands  available  to  a particular 
installation  and  the  descriptions  and  usage  of  those  commands 
are  given  in  Part  II,  Section  t>. 
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7.  MODIFIER  COMMANDS 


All  the  commands  in  this  sort  ion  modify  t ho  UFA  data  base  in 
some  manner  and  generate  an  output  fo  present  the  result  of  the 
modification.  Those  outputs  provide  the  user  with  a permanent 
record  of  changes  made  to  the  problem  statement  in  the  data 
base. 


Effect  of  ilaJlliSI  ISJUSSids  on  the  Data  Pas£  jj  tJLSJCtur^ 

There  are  basically  three  types  ot  information  stored  in  a UFA 
data  base: 


1)  Name  and  types  of  objects  defined  by  the  user. 

2)  Comment  entries  (narrative  and  free  format  descriptions  of 
objects)  . 


3)  Connections  amonq  objects  and  between  an  object  and  comment 
entry. 

All  this  information  is  entered  into  the  data  base  via  INrUT-PSL 
from  the  URL  statements  used  as  input  t.o  this  command.  In  most 
cases  the  section  header  statements  define  the  typo  ot  objects 
and  names  of  the  objects,  comment  entry  statements  (DFSCF I TTION , 
for  example)  define  comment  entries  to  be  stored,  and  other  UFL 
statements  define  relationships  or  connections  among  the  named 
objects  in  the  data  base.  To  present  the  structure  of  the  data 
base  in  a graphical  manner,  the  followin'!  symbols  will  be  used: 


- symbol  for  record  used  to  describe  a 
given  named  object,  (name  record). 


- symbol  for  comment  entry  stored  in  data 
base. 


- symbol  for  a NTJM,  a type  ot  record  used 
to  make  connections  among  objects  and 
between  an  object  and  comment  entry. 


Using  the  above  notation,  a simple  relationship  between  two 
objects  (name  records)  many  look  like; 
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Data  in  the  NUB  detines  the  type  of  connection  (RECEIVES,  for 
example)  and  the  direction  of  the  arrows  defines  the  manner  in 
which  the  relationship  should  he  interpreted,  i.e.,  which  object 
does  the  PECEIVING. 

A connection  between  an  object  and  a comment  entry  may  look 


The  data  in  the  NUB  defines  the  type  of  comment  entry 
(PROCEDURE,  for  example)  . 

It  is  important  to  note  that  the  connections  made  amopg  objects 
are  different  rrom  the  connection  made  between  an  object  and 
comment  entry. 

INPUT-PSL  creates  records  for  named  objects,  the  NUB  records 
connecting  the  objects,  and  the  comment  entries.  Commands  must 
also  be  available  to  do  the  following: 

1)  Change  a name  record 

i)  change  the  name  of  the  object 
ii)  change  the  object  type 

2)  Delete  a connection  between  objects 

3)  Delete  a name  record  (and  any  connections  it  had  with  other 
objects) 

4)  chanqe  comment  entry 

5)  Delete  a comment  entry 

URA  has  facilities  to  perform  all  of  these  modifications  on  the 
data  base  information.  The  following  URL  commands  perform  the 
actions  corresponding  to  the  above: 

1)  Change  a name  record: 

i)  Change  the  name  of  an  object: 

RENAME  - This  command  chanqes  information  within 

t.he  name  record  only. 

ii)  Change  the  object  type: 

CHANGE-TYPE  - This  command  changes  information  within 

the  name  record  only. 


A. 
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2)  Delete  connections  among  objects: 


DELETE-PSL 


3)  Delete  name  records: 


DELETE 


- This  command  deletes  NUBS  (and  thus 
connections)  among  name  records  in  the 
data.  It  does  not  delete  name  records 
or  comment  entries. 


This  command  deletes  name  records. 

Names  to  be  deleted  having 
connections  with  other  names  and/or 
having  comment  entries  associated 
with  them,  will  have  corresponding  NUBS 
(and  comment  entries)  deleted. 


4)  Change  comment  entries: 

F EPLACE- COMMENT- ENTFY 

- This  command  changes  information  within 
the  comment  entry  only. 

5)  Delete  comment-entries: 

D EL ETE-COMMENT- ENTRY 

- This  command  deletes  comment  entries 
and  also  deletes  corresponding  HUBS. 


Modifier  Command  Description  Format 

Each  Modifier  Command  will  be  described  in  the  following  format: 


Command  JjJame  (command  abbreviation) 

When  specifying  the  command  to  be  executed,  either  the  long  form 
of  the  command  name  or  legal  abbreviations  of  the  name  may  he 
given. 


All  Modifier  Commands  change  information  in  the  UFA  data  b$se. 
What  type  of  information  is  chanqed  and  how  it  is  changed  is 
described.  Also,  the  checks  made  bv  UFA  before  the  change  is 
made  are  presented. 


All  Modifier  Commands  generate  an  output  to  present  the  result 
of  the  modi f ication  (s)  made.  The  name  of  the  output,  purpose  of 
the  output,  contents,  and  diagnostics  given  in  the  output  are 
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presented  to  aid  ..n  using  it. 


Execution 

The  basic  form  of  specifying  the  command  to  be  executed  is 
described.  An  example  of  how  this  is  done  and  the  results  from 
the  action  are  given. 


Options  and  Alternatives 

All  Modifier  Commands  can  be  executed  in  more  than  one  way.  For 
example,  a different  form  of  the  command  may  be  used  to  change 
one  name  in  the  data  base  versus  a number  of  names.  Also,  the 
effect  which  the  parameters  for  the  command  have  on  modifying 
the  data  is  described.  Examples  are  given  to  illustrate  the 
alternatives. 


Common  Errors 

It  is  possible  to  make  particular  errors  in  the  use  of  each 
Modifier  Command.  Some  of  the  particular  logical  and 
syntactical  errors  that  occur  when  executing  the  command  are 
given. 

The  following  commands  are  described  in  this  section  in 
alphabetical  order: 

7.1  CHANGE- TYPE 

7.2  DELETE 

7.3  DEL ET E- COMM ENT-ENTHY 
7.U  DFLETE- PEL 

7.5  INPUT-PSL 

7.6  PUNCH-CCMMENT-ENTFY 

7.7  RENAME 

7.8  REPLACE- COMM  ENT- ENT BY 


7. 1 CHANGE-TYPE  JCJl 
Modification  Made 

Each  name  specified  as  input  to  this  command  has  its 
corresponding  nam®  tyne  changed  if  the  new  type  does  not 
conflict  with  the  context  in  which  the  name  has  previously  been 
used.  This  modification  is  most  often  used  to  change  an 
underlined  name  (**»  UNDEFINED  ***)  to  a specific  name  type 
(such  as  GROUP  or  ELEMENT)  . Various  "checking''  facilities  must 
be  used  to  ascertain  that  legal  chanqes  are  being  made.  For 
each  name  type  change,  UFA  must  check  to  see  that: 

i)  The  name  whose  name  type  is  to  be  changed  exists  in  the  data 
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base. 

ii)  The  assignment  of  the  new  name  type  is  consistent  with  the 
context  in  which  the  name  was  used  previously. 


2lii£J4i  description 

The  output  qenerated  by  this  command  is  the  CHANGE-TYPE  PEPOFT. 
This  report  presents  for  each  name  used  as  input  to  the 
CHANGE-TYPE  command,  the  name,  the  old  name  type  associated  with 
it  and  the  new  name  type  now  assigned  to  it.  Any  error 
diagnostics  which  may  occur  during  the  name  type  change  will 
also  be  printed.  The  names  are  printed  out  in  the  same  order  ir 
which  they  were  read  as  input  to  the  CHANGE-TYPE  command. 


Siesiiiisn 

To  change  the  name  type  of  only  one  name,  the  following  command 
format  is  issued: 

CHANGF-TYPF  NAKF=qross-pay  TYPE=GFOUP 

Previously  in  the  problem  statement,  "gross-pay"  had  been 
defined  as  a ELEMENT.  It  was  more  appropriate  to  call  it  a 
GROUP,  and  the  CHANGE- TYPE  command  made  it.  easy  to  facilitate 
this  chanqe.  The  resulting  CHANGE-TYPE  FFPOFT  is  shown  in 
piqure  2.  Options  and  Alternatives 

1)  The  name  types  of  several  names  can  be  changed  at  one  time 
if  the  names  are  put  into  a file  and  the  file  is  specified 
as  input  to  the  command.1  (This  is  usually  done  via  the 
FILE  parameter.)  Fiqure  3 is  an  output  resulting  from  using 
a file  as  input  to  CHANGE-TYPF.  All  the  names  in  the 
example  are  shown  to  have  been  previously  defined  as 
ELEMENTS.  The  report  shows  that  "bir thdate"  was  chanqed  to 
a GROUP,  "number- o f-deduct ions"  became  a GROUP,  "surname"  a 
GROUP  and  "qross-pay"  changed  back  to  an  LLEMENT,  Each 
line  of  the  input  file  consists  of  the  name  of  an  object 
followed  by  the  new  name  type  to  be  assigned  to  it.  The 
format  is  acceptable  if  the  name  is  followed  by  its  new 
name  type  and  thrt  two  are  within  the  first  eighty  columns 
of  the  file  line  and  there  is  at  least  one  blank  between 
them.  The  file  used  to  generate  Figure  3 was: 

birthdate  GROUP 
number-o f-d educt ions  GFCMP 
surname  GFO'JP 
qross-pay  ELEMENT 


* That  exact  manner  in  which  f ho  file  is  specified  is  given  in 
Part  II,  Section  7.1. 
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?)  The  "-yrr  [MiMamti'i'  cat  also  he  used  effectively  with  an 
input,  file.  All  names  in  the  input  file  will  have  their 
name  typos  changed  to  the  name  type  specified  by  the  TYPF 
parameter.  It  the  tile  from  the  previous  example  was 
specified  ns  input  and  the  TYPF  parameter  was  also  used, 
only  the  names  in  the  tile  would  he  read  as  input;  the  name 
tvnes  would  he  ignored.  All  the  names  specified  in  the 
input  til»>  would  have  their  name  types  changed  to  that 
qi ven  hy  the  TYPE  parameter.  Figure  4 presents  the  output 
resulting  : 10s  a CHANGE-TYPE  command  with  TYPK  = h.LEHEN7  ard 
the  names  used  as  input  are  the  same  as  that  used  tor 
Figure  3. 

3)  It  is  sometimes  i l var.t  ugeous  to  use  NAX^-GFN  in  conjunction 
with  CHANG:.- TYPE  , i.e.  , use  the  output  produced  hy  NAFE-CFN 
as  input  to  CHANG l- TYPF . This  is  most  often  done  when  all 
names  of  i particular  type  (usually  UNDEFINED)  are  changed 
to  another  type  (GROUPS  or  ElEELSTS) . To  change  all 
undefined  names  in  th*  data  base  to  GFOUPS: 

VAF  E-GEN  J?=  ' UN  DFFINEP  ' 

CHANGI -TYPE  FI  It  TYPE^GFOUF 

The  NAEE-GEN  command  selects  all  undefined  names  and  places 
them  in  a file.  The  CHANGE-TYPE  command  then  uses  the  file 
produce!  hy  NAftF-GF\  us  its  input  file.  The  TYPE=GKOUP 
parameter  specifies  that  all  the  names  in  the  input  file 
should  he  changed  to  GROUPS.  Figure  5 presents  the  result 
of  this  procedure. 


Comm^Q  rtor s 

It  neither  ar.  input  file  nor  NAI“.F  is  specified  for  the  command, 
the  message;  "NO  SAFE  GIVdN"  will  he  printed  by  UFA.  If  a file 
or  SAKE  is  giver,  hu*  no  name  types  are  given  in  the  file  or  no 
TYPE  is  given,  the  message:  "NO  TYPE  GIVEN  WITH  "NAME* " OF 
"FILE"  rAFAHETEF  will  he  printed.  Fhould  either  of  these 
messages  be  generated,  UFA  will  not  execute  the  CHANGE-TYPE 
command.  The  command  and  its  parameters  should  be  re-entered 
with  the  necessary  corrections.  Another  common  error  is 
attempting  to  assign  a new  name  tvpe  to  a name  that  has 
previously  been  used  in  a way  that  conflicts  with  its  new  name 
type.  Fot  example,  it  the  name  XYZ  was  previously  defined  to  be 
CONTAINED  in  SET  51,  tins  would  imply  that  XYZ  must  be  either  an 
ENTITY,  INPUT  or  OUTHT.  It  an  attempt  was  made  to  change  its 
type  tc  a GROUP  (which  cannot  be  CONTAINED  in  a SET)  the  error 
message : 


UF AO 29 : M A INCT:  CONFLICT  WITH  tXISTING  CONNECTIONS 

would  be  giv»n  and  the  change  would  not  ha'  made.  If  it  is  still 
desired  that  X Y he  a IFOUP,  XYZ  should  be  deleted  tiom  the  data 
base  an  1 proper  UFL  statements  tor  XYZ  should  be  entered  via 
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INPUT-PSL.  All  conflicting  connec*- ions  are  listed.  They  all 
oust  be  resolved  before  the  change  of  type  can  occur. 


7.  2 Delete  (DLL) 

por  each  name  specified  as  input  to  the  DELETE  command,  all  its 
relationships  (i.e.,  USES,  SUPPAPTS,  etc.),  with  other  names  in 
the  data  base  are  removed,  its  common*-  entries  (such  as 
DESCRIPTION  or  PROCEDURE)  are  deleted  and  tinallv  the  name  is 
deleted  from  the  data  base.  Petorc  any  of  these  modifications 
are  made,  CJPA  checks  that  the  name  to  be  deleted  exists  in  the 
data  base.  It  the  name  canr.ot  be  found,  r.o  attempt  will  be  made 
by  USA  to  leleto  the  name. 


Output  Description 

The  DELETION  REPORT  is  produced  each  time  this  command  is 
initiated.  Each  name  used  as  input  to  the  DELETF  command  is 
printed  on  the  report  along  with  the  status  of  the  change  (i.e., 
if  it  did  or  did  not  work).  The  names  on  the  output  appear  in 
the  same  order  as  read  by  th®  PELETr  command. 

This  report  serves  as  a permanent  record  of  names  that  have  been 
deleted  from  the  UP?  data  base.  It  is  intended  to  aid  the 
analyst  in  keepinq  track  of  modif  ica*-ions  to  the  data  base. 

Once  there  is  a record  of  a particular  name  beinq  deleted,  the 
analyst  has  the  option  of  re-usinq  the  name. 


Execution 

The  following  command  deletes  one  name  from  the  data  base: 

DELETE  NA*S  = remaininq-f un  is 

The  DELETION  REPORT  for  this  action  is  shown  in  Figure  f. 


Options  and  Alternatives 

1)  Several  names  car.  be  deleted  from  the  dati  base  if  the  names 
are  put  into  a file  and  the  file  is  specified  as  input  to  the 
command.*  (This  is  usually  done  via  the  FILE  parameter.)  The 
format  of  the  input  file  consists  of  one  name  per  line, 
beginning  in  cclumn  one.  Figure  7 is  an  output  resulting  from 
using  a file  as  input  to  the  DELETF  command.  All  the  names  in 


* The  exact  manner  in  which  the  file  is  specified  is  given  in 
Part  II,  Section  7.2. 
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the  report  had  been  dot  inert  in  the  data  base.  The  report  shows 
that  deletion  of  each  name  was  successful. 


Common  K^t or s 

DELATE  should  not  be  used  to  delete  the  entire  contents  of  the 
data  base.  Operating  system  command  should  be  utilized  for  this 
procedure,  ’’'lie  data  base  should  be  emptied  and  then 
reinitialized. 

When  doinq  minor  editinq  of  a URI  description  for  a name  in  the 
data  base  the  information  connected  to  that,  name  (UH 
statements)  should  bo  saved  before  deleting  the  name,  A 
FORM  ATT ED-PROBLEM "STATEMENT  tor  the  name  should  be  qenerated 
usinq  the  PUNCH  parameter.  Then  the  name  can  be  deleted  (via 
DEI  ETE)  from  the  data  base.  At  this  point.,  the  old  information 
in  the  PUNCH  file  can  bo  edited  to  suit  the  problem  definer  and 
then  re-entered  via  the  INPUT-PSL  command  using  the  PUNCH  file 
produced  by  the  EPS  as  input. 

If  a file  is  used  as  input  to  the  command,  all  names  to  be 
deleted  mus£  begin  in  the  first  column  of  the  tile  line.  Any 
preceding  blanks  will  be  interpreted  as  part  of  the  name. 

If  neither  an  input,  tile  nor  NAME  is  specified  for  the  command, 
tho  messaqe:  "NO  NAME  OR  FILE  WAS  SPECIFIED"  will  be  printed  by 
UFA.  Should  this  happen,  UFA  will  not  execute  the  DELETE 
command.  The  command  an!  its  parameters  should  be  reentered 
with  the  necessary  corrections. 


7. 3 DELETE- COMMENT-ENTRY  JDCOM}. 
Modification  ^de 


The  DELETE-COMMENT— FN TR V takes  those  names  specified  as  input 
and  deletes,  for  each  input  name,  the  comment  entries  associated 
with  those  comment  entry  types  designated  as  command 
parameters.*  If  no  comment  entry  types  are  specified  by  the 
parameters,  no  comment  entries  will  be  deleted,  Checkinq  is 
performed  to  see  if  the  comment  entry  exists  in  the  data  base 
before  it  is  deleted.  If  the  comment  entry  cannot  be  found,  no 
attempt  is  made  to  delete  it. 


Description 

The  output  repoit  generated  by  this  command  is  called  DELETED 


» An  example  ot  a comment  entry  type  is  a URL  "DESCRIPTION"  or 
"PROCEDURE"  statement.  The  comment  entry  associated  with  this 
comment  entry  type  would  be  the  text  specified  by  the  user 
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COMMENT  ENTRIES.  For  each  comment  entry  to  be  deleted  from  the 
data  base,  the  following  information  is  printed  on  the  output: 


- name  in  the  data  base  to  which  the  comment  entry  belonged. 

- the  type  ot  comment  entry  (i.e.,  DESCRIPTION,  PROCEDURE,  etc.) 
which  is  being  deleted. 


- the  full  text  of  the  comment  entry. 

The  order  of  the  output  names  is  the  same  as  the  order  of  the 
input  names. 

This  servos  as  a hard  copy  record  for  those  comment  entries 
deleted  from  tho  system  aescript ion . As  stated  before,  it  is 
desirable  to  have  all  modifications  to  the  system  description 
documented. 


&§£  align 

The  following  command  deletes  the  PROCEDURE  comment  entry 
associated  with  one  name. 

DCOM  NAME=employeo- processing  PROCEDURE 

This  was  done  because  the  prcblem  rfefiners  wanted  to  delete 
current  PROCEDUPE  comment  entry  and  did  not  want  to  replace  it. 
If  the  comment  entry  could  be  correct  if  edited  or  a replacement 
was  available,  then  it  would  be  more  appropriate  to  use  the 
REPLACE" COM MENT-ENTF Y command  (see  section  7. 8)  . The  output 
generated  by  this  command  is  shown  in  Figure  8, 


2illigns  and  AilSIMllies 

1)  Multiple  comment  entries  can  be  deleted  for  a name: 

DCOM  NAME=new-in to- validation  PROCEDURE  DESCRIPTION 

In  this  case,  the  PROCEDURE  and  DESCRIPTION  comment  entries 
would  be  deleted  for  the  PFOCRRS,  " new- i nf o- val idat ion . " 


2)  The  following  types  of  comment  entries  can  be  deleted  when 
specified  as  parameters  for  DFI.FTS-COMMENT-ENTF.Y : 

DERIVATION 

DESCRIPTION 

FALSE-WHILE 

PROCEDURE 

TRUE- WHILE 

VOLATILITY 

VOLATILITY-MEMDFF 

VOLATILITY-SET 


U 
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3)  Several  names  can  have  their  comment  entries  deleted  if  the 
names  are  put  into  a file  and  the  file  is  specified  as 
input.  The  comment  entries  deleted  for  these  names  are 
those  specified  as  parameters  for  the  command.  If  the  user 
specifies  that  the  DESCRIPTION  and  PROCEDURE  comment 
entries  he  deleted  for  a GFOMP  name,  the  DESCRIPTION 
comment  entry  will  he  deleted  and  the  message: 

URA1C4:  DELSET:  PROCEDURE  CON  WENT  ENTRY  NOT  FOUND 

will  he  given  because  C.FOUPS  may  not  have  PROCEDURE 
statements . 

Figure  9 shows  the  output  resulting  frcm  executing  the 
DElETE-COMMENT* ENTFY  command  with  a file  of  names  as  input 
and  DESCRIPTION  and  PROCEDUFF  comment  entry  types  as 
parameters.  The  example  shows  for  each  name  used  as  input, 
each  comment  entry  deleted  for  the  name. 

4)  Printing  of  the  DELETED  COMMENT  ENTRIES  output  may  be 
suppressed  by  specifying  NOPRINT  as  a parameter: 


DCOM  NAME=payrol 1-processing  DESCRIPTION  NOPRINT 


CgHlgfl  Irrars 

If  neither  an  input  file  nor  NAME  is  specified  for  the  command, 
the  message  "NONANE  OK  FILE  SPECIFIED"  will  he  printed  by  UPA. 
Should  this  happen,  UFA  will  not  execute  the 

DELETE-COMMENT-ENTRY  command.  The  command  and  its  parameters 
should  be  reentered  with  the  necessary  corrections. 


7.4  DELETE- PSL  (DPSL) 
fl2diiicatjon  flade 

This  command  takes  as  inputf  any  UF L statements  in  the  format 
specified  in  the  "User  Requirements  Language,  Version  3.3 
Language  Reference  Manual."1  For  each  section  header  statement 
(i.e.,  PROCFSS,  DEFINE,  etc.)?  all  the  UF L statements  following 
this  section  header  (up  to  the  next  section  header  statement) 
will  be  deleted  from  the  UFA  data  base  for  those  names  specified 
in  the  header  statement.  This  command  only  deletes 
relationships  between  names  and  does  not  delete  any  comment 
entries  (this  is  handled  by  the  DCCK  command)  nor  deletes  names 
(this  is  handled  by  the  DELETE  command) . It  some  of  the 
information  presented  by  the  UPL  statements  is  cont radictoi y , an 


» Part  II  of  the  URL  User's  Manual. 

* See  Appendix  F of  the  URL  User's  Manual.  List  of  all  possible 
section  header  types. 
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error  message  will  bo  .liven  tor  that  statement.  Error 
diagnostics  are  also  given  when  syntactical  errors  occur.  UPA 
attempts  to  continue  the  procedure  until  too  many  errors  are 
encountered . ‘ 


Output  pe script  Ion, 

The  two  outputs  that  may  be  Generated  by  this  command  are 
DEL  F TED  UFL  and  the  UFA  CROSS  REFFRFNCE.  The  DELETED  URL  output 
is  a recorl  of  all  information  (except  names  and  comment 
entries)  deleted  trem  the  UFA  data  bast.  It  aids  the  analyst  in 
finding  errors  in  the  deletion  procedure  and  produces  error 
diaqnostics  in  sufficient  detail  to  aid  the  analyst  in 
correctinq  these  errors.  This  output  displays,  line  for  line, 
the  data  used  as  inptit  to  the  PEIETE-PSL  command.  No  reorderinq 
is  done  on  the  input  data. 

The  UFA  CROSS  PEFEFFNCS  is  intended  as  an  aid  to  the  analyst  in 
correctinq  errors  that  appear  in  the  DELATED  UFL  output.  It 
consists  of  an  alphabetical  list  of  all  user  defined  names, 
i.e.,  non-UFL  names  that  appear  in  the  DELETED  UFL  output.  For 
each  name  that  appears  in  the  CFCSS  FEFEFENCE,  its  corresponding 
name  type  (as  qiven  in  the  DELETED  UFL  output)  is  printed  and  a 
list  of  all  lines  in  the  DELETED  UFL  output  where  the  name 
appeared  is  also  qiven. 


Execution 

The  most  common  method  of  deletinq  URL  statements  is  by  first 
vritinq  all  statements  to  be  deleted  into  a file  (or  punching 
them  on  cards)  and  then  using  this  as  input  to  the  command.* 
(This  is  usually  done  via  the  INPU'’'  parameter.)  Only  the  first 
72  columns  of  each  line  in  the  file  may  contain  URL  statements. 
Anything  after  column  72  is  ignored.  Figure  1C  is  the  output 
resulting  from  this  type  or  procedure.  The  EOF  statement  must 
be  qiven  to  specify  the  end  of  URL  statements  to  be  deleted. 


Optjqqs  and  A 1, t o r n a t j v ■; s 

1)  In  many  cases  the  amount  of  input  is  relatively  large  (a 
few  hundred  lines) ; hence,  there  may  be  a need  for  the  UFA 
CFOSS  REFERENCE.  It  will  be  qenerated  by  specifying  the 
XFEF  parameter  with  the  command. 

2)  If  no  input  file  is  specified,  UFA  will  wait  for  URL 
statements  to  be  typed  in  (from  the  terminal)  , or  when  in 


1 See  Section  9 for  the  limit  of  errors  allowed. 

* The  exact  manner  in  which  the  file  can  be  specified  is  given 
in  Part  II,  Section  7.4. 
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hatch  mode,  interpret  anv  following  cards  up  through  the 
first  ''EOF"  as  UFL  statements  to  be  deleted.  When  UPt 
statements  are  entered  at  the  terminal,  each  line  entered 
is  echoed  back  by  U PA  along  with  any  errors  encountered  for 
that  statement  (i.e.,  an  AS-IS  SOURCE  LISTING).  This 
allows  the  user  to  correct  errors  as  they  occur. 

3)  Printing  of  the  DELETED  UFL  output  may  be  suppressed  by 
specifying  N0SGUPC2  as  a parameter. 


Common  Errors 

The  most  common  errors  are  typing  errors  encountered  in 
interpreting  the  UFL  statements.  A typing  mistake  can  cause 
many  different  tvpes  of  syntactical  and  semantic  errors. 

Only  the  first  72  columns  of  each  line  in  the  input  tile  are 
reau  so  all  URL  statements  should  fit  in  this  reqion.  Anything 
over  column  72  will  be  truncated  and  an  error  message  will  he 
generated  in  most  cases. 

Omittinq  the  semicolon  at  the  end  of  a URL  statement  is  a common 
cause  for  several  errors. 

DELETE- PSL  will  not  delete  comment  entry  statements  from  the 
data  base  so  these  statements  are  ignored  if  encountered  in  the 
input  file.  No  names  other  than  SYNONYMS  can  be  deleted  from 
the  data  base  via  DELETE- PSL. 

The  last  line  of  the  input  tile  containing  the  URL  statements 
should  have  the  *ord  EOF  signifying  the  end  of  input.  This 
should  also  be  typed  when  inputting  the  data  interactively.  EOF 
allows  the  return  to  the  UFA  command  handler.  No  URL  statements 
are  read  atter  EOF. 


7 • 5 INPUT— PSL  XI ?l 
Modification  fiade 


This  command  ta 
specified  in  "U 
Reference  Manua 
PROCESS,  DEFINE 
section  header 
base  (if  not  al 
following  this 
statement,  spec 


kes  as  input,  any  UFL  statements  in  the  format 
ser  Requirements  Language,  Version  3.  3,  Language 
1."*  For  each  section  header  statement  (i.e., 

, etc.)*  the  user  defined  names  specified  by  that 
will  be  added  to  the  list  of  names  in  the  data 
ready  in  the  data  base)  . All  the  URL  statements 
section  header  up  to  the  next  section  header 
ity  connections  to  be  made  with  ctaer  names  in 


‘ Part  II  of  the 
* See  Appendix  F 
header  typos. 
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the  data  base.  UFA  tirst  performs  syntax  and  semantic  checks  on 
each  input  line  before  any  more  complex  checkinq  is  performed. 

An  "in  context"  check  is  made  for  each  name  used  as  input.  If 
the  name  is  not  in  the  user’s  da*a  base,  it  is  added.  If  it  is, 
a check  is  made  to  see  that  the  context  in  which  the  name  is 
used  in  the  new  input  aqrees  with  the  manner  in  which  the  name 
is  used  in  the  data  base.  If  there  is  a conflict,  an  error 
message  will  be  produced  an-d  UFA  will  skip  to  the  next  input 
statement.  UFA  attempts  to  continue  the  input  procedure  until 
too  many  errors  are  encountered.1  Zf  redundant  intormation  is 
given,  i.e.,  specifying  the  same  relationship  more  than  once, 
the  redundant  information  will  no*  be  added  to  the  information 
already  in  the  data  base.  No  diagnostic  message  is  given  to 
denote  redundant  information. 


Output  Description 

The  two  outputs  that  may  be  aenerated  by  this  command  are  the 
UFA  AS-IS  SOUFCE  LIFTING  and  the  UFA  CROSS  REFERENCE.  The  UFA 
AS-IS  SOUFCF  LISTING  is  a record  of  all  information  input  into 
the  UFA  data  base,  and  is  intended  as  an  aid  to  the  analyst.  It 
aids  the  analyst  in  finding  errors  in  the  input  data  and 
produces  error  diagnostics  in  sufficient  detail  to  aid  th>* 
analyst  in  correctinq  these  errors.  The  output  displays,  line 
for  line,  the  data  used  as  input  t.c  ’'if  INPUT-PSL  command.  ’’’he 
order  of  the  input  data  is  not  chanaed. 

The  UFA  CFOSS  REFERENCE  is  intended  as  ar.  aid  to  the  analyst  in 
correcting  errors  that  appear  ir.  the  UFA  AS-IS  SOURCE  LISTING 
and  also  to  resolve  ambiguities  in  assigning  name  types  to  the 
undefined  names  in  the  listinq.  It  is  useful  in  correctinq 
errors,  as  any  name  involved  in  an  error  can  be  quickly 
referenced  to  find  all  places  in  the  \S-IS  LISTING  where  the 
name  is  used,  and  the  name  type  assiqned  to  that  name. 

From  this  information,  the  analyst  will  be  able  to  determine 
what  information  has  to  be  reenfered  to  correct  the  error. 

Since  the  CFOSS  REFERENCE  also  presents  all  those  names  which 
have  an  ambiguous  name  type  (one  that  was  not  defined  in 
previous  input),  the  analyst  can  resolve  those  ambiguities  by 
use  of  the  CHANGE-TYPE  or  INPUT-PSL  commands.  The  output 
consists  of  an  alphabetical  list  of  all  user  defined  names, 
i.e.,  non-'JRL  names,  that  appear  ir  the  AS-IF  LISTING.  For  each 
name  that  appears  in  the  CFOSS  FEFEFSNCE,  its  correspondinq  name 
type  (as  given  in  the  AS-IS  LISTING)  is  printed  and  a list  of 
all  lines  in  the  AS-IS  LISTING  where  the  name  appeared  is  also 
given. 


* See  Section  9 for  the  limit  of  errors  allowed. 
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Fxecut ion 

The  most  common  method  ot  inputting  URL  statements  is  by  first 
writing  all  statements  to  be  added  into  a file  (or  punching  then 
on  cards)  and  i-ht  n using  this  as  input  to  the  command.1  (This  is 
usually  done  via  the  IN^UT  parameter.)  Note  that  only  the  first 
7 2 columns  of  each  line  in  the  file  may  contain  URL  statements. 
Anything  after  17  is  ignored.  Figure  11  is  the  output  resulting 
from  this  type  of  procedure.  The  FOF  statement  must  be  qiven  to 
specify  the  end  of  URL  statements  to  be  added.  The  UPDATE 
parameter  specifies  that  the  URA  data  base  is  to  be  modified  by 
the  input.  It  this  parameter  is  not  given,  none  of  the 
information  will  be  added  to  the  data  base. 


Options  2Hli  A 1 1 e r native  s 

1)  In  many  cases,  when  the  amount  ot  input  is  relatively  large 
(a  few  hundred  lines)  there  may  be  a need  for  the  URA  CFOSS 
FEFEFFNCL.  By  simply  specifying  XRFF  as  a parameter,  it 
will  be  generated.  Figure  12  presents  an  AS-IS  LISTING  and 
CROSS  FFFEFENCE  for  a small  problem  statement. 


2)  In  most,  cases,  it  is  advantageous  to  first  do  a syntax  and 
semantic  check  ot  the  input  data  befote  attempting  to  put 
it  in  the  data  base.  By  not  specifying  the  UPDATE 
parameter,  *-hese  checks  will  be  made  without  actually 
putting  the  information  into  the  data  base.  This  will 
generate  an  AS-IS  LISTING  with  “ccot  diagnostics  for  the 
URL  statements  used  as  input.  Since  most  problem 
statements  have  one  or  two  typing  errors  anyway,  this 
proves  to  be  ar.  inexpensive  way  to  catch  errors  early. 

After  the  source  of  the  errors  has  been  determined  and 
corrected,  the  command  can  be  issued  again  using  UPDATE  as 
a parameter. 

3)  If  no  input  file  is  specified,  URA  will  wait  for  UFL 
statements  to  be  typed  in  (from  the  terminal),  or  when  in 
batch  mode,  interoret  any  following  cards  up  through  the 
first  "ECF"  as  URL  statements  to  be  added  to  the  data  base. 
When  UFL  statements  are  entered  at  the  terminal,  each  line 
entered  is  echoed  back  by  UFA  along  with  any  errors 
encountered  for  tnat  statement  (i.e.,  an  AS-IS  SOURCE 
LISTING).  This  allows  the  user  to  correct  errors  as  they 
occur. 

*4)  Printing  ot  the  AS-ls  SOURCE  LISTING  may  be  suppressed  by 
specifying  NOSOUFCE  as  a parameter. 

5)  The  DBREF  parameter  allows  referencing  of  the  data  base 


1 The  exact  manner  ir  which  the  file  can  be  specified  is  given 
in  Part  II,  Section  7.5. 
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when  semantic  as  well  as  syntax  checks  are  desired  for  UFL 
statements  used  as  input.  This  must  he  in  effect  when 
UPDATE  is  qiven  as  a parameter.  NC  DBF  FF  may  be  specified 
if  only  a syntax  check  of  the  statements  is  desired  and  the 
data  base  is  not  to  be  updated. 


£225121!  Errois 

The  most  common  errors  are  typina  errors  encountered  in 
interpreting  the  URL  statements.  A *ypinq  mistake  can  cause  so 
many  different  types  of  syntactical  and  semantic  errors  that  it 
will  be  handled  in  a later  section  (section  10). 

It.  is  also  nossible  to  input  the  new  information  into  the  wronq 
data  base.  It  is  important  that  the  data  base  to  be  used  has 
been  specified.  Otherwise,  the  data  base  may  be  set  to  some 
default  which  may  not  be  the  data  base  file  desired. 

The  INPUT-PSL  command  only  reads  *he  first  72  columns  of  each 
line  in  the  input,  file  so  all  URL  statements  must  fit  in  this 
reqion.  Anythinq  over  column  72  will  be  truncated  and  an  error 
messaqe  will  be  qiven  in  most  cases. 

Omittinq  the  semicolon  at  the  end  of  a UFL  statement  is  a common 
cause  for  several  errors.  It  is  important  that  the  syntax  of 
each  URL  statement  be  correct. 

The  last  line  of  the  input  file  containing  the  UFL  statements 
should  have  the  word  EOF  siqnifyinq  the  end  of  input.  This 
should  also  be  typed  when  inputting  the  data  interactively.  EOF 
allows  the  return  to  the  UFA  command  handler.  (See  Fiqures  11 
and  12  to  see  how  EOF  is  used  correctly.)  No  URL  statements  are 
read  after  EOF. 


7. 6 PUNCH-COMMENT" ENTRY  JFCOF1 
Modification  flade 

Technically,  the  output  produced  by  this  command  is  a report 
presentinq  narrative  information  in  the  manner  of  a qlossary. 

It  makes  no  modifications  to  the  data  base,  but  is  presented 
here  because  its  main  ohlectivo  is  to  aid  the  analyst  in 
changinq  comment  entries  in  conjunction  with  the 
FEPLACE-COMMENT-ENTF Y command.  The  idea  of  usinq  the  output  as 
a qlossary  (for  final  specifications  perhaps)  however,  should 
not  be  overlooked.  A message  is  aiven  when  no  comment  entry  is 
available  tor  a particulrr  comment  entry  type  or  the  name 
specified  is  no*  in  the  data  base. 


' 


£2£cii£ti2n 
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The  PUNCHED  COMMENT  ENTRIES  output  is  generated  by  this  command. 
It  presents  selected  comment  entries  tor  each  name  used  as  input 
to  the  command.  Any  typo  of  name  may  be  used  as  input  to  the 
command.  Depending  on  the  type  of  name  the  following  comment. 


entries  may  be  retrieved: 


DERIVATION 

(DEE) 

DESCRIPTION 

( DE  SC) 

FALSE” WHI I F 

(FW) 

PROCEDURE 

(PFCD) 

TRUE- WHILE 

(TW) 

VOLATILITY 

(VOL) 

VOLATILITY” MEM  HER 

(VOLM) 

VOLATILITY-SET 

(VOLS) 

For  each  name  used  as  input  to  the  command,  the  name  is  printed 
on  the  output  in  the  order  in  which  it  was  read  and  associated 
with  that  name,  the  type  of  comment  entry  and  the  text  for  that 
comment  entry  (tor  each  type  of  comment  entry  as  specified  in 
the  parameter  list)  . 


Execution 

To  obtain  the  DESCRIPTION  comment  entry  for  one  name  the 
following  command  might  he  given: 

PC  CM  N AM E=pay roil” processing  DESCRIPTION 

This  will  generate  the  report  shown  in  Figure  13.  A PUNCH  file 
will  also  be  generated  with  the  same  information  as  the  roport. 
The  manner  in  which  the  file  to  contain  the  PUNCH  data  is 
specified  is  installation  dependent,  and  given  in  Part  II, 

Section  7.6.  If  the  procedure  is  done  at  the  terminal,  the 
PUNCH  file  can  then  be  edited  and  used  as  input  to  the 
RE PLACE- COM  WENT- ENTRY  command  to  modify  the  comment  entry.  If 
the  procedure  is  done  in  hatch,  the  contents  of  the  PUNCH  file 
produced  should  be  punched  on  cards  (by  the  system  if  possible). 
Then  the  deck  of  cards  produced  can  be  modified  and  used  as 
input  to  REPLACE- COMM  ENT  * lNT  F Y in  the  next  batch  run. 


OP*-  ions  and  Alternatives 

1)  Several  names  can  have  comment  entries  printed  and/or 

PUNCHED  it  the  names  are  put  into  a file  and  the  file  is 
specified  as  input  to  the  command.1  (This  is  usually  done 
via  the  FILE  parameter.)  Figure  14  is  an  output  resulting 
from  using  a file  as  input  to  the  PCOM  command. 


1 The  exact  manner  in  which  the  file  is  specified  is  given  in 
Part  II,  Section  7.6. 
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2)  Multiple  comment  entries,  such  as  DESCRIPTION  anti 
PROCEDURE , can  be  generated  for  several  names  when  a file 
is  specified  as  input  and  more  t-han  one  comment  entry  type 
is  specified  as  parameters.  This  is  illustrated  in  Fiqure 

15. 

3)  When  the  objective  of  executing  this  command  is  to  qenerate 
a PUNCH  file,  printinq  of  the  report  may  he  suppressed  by 
issuinq  NOPFINT  as  a parameter. 

4)  When  the  objective  of  executina  this  command  is  to  qenerate 
the  reoort  {and  no  PUNCH  data  is  desired),  production  of 
data  in  the  PUNCH  file  may  be  suppressed  by  issuinq  NOPUNCH 
as  a parameter. 

5)  The  NAMF-GFN  can  also  be  used  in  conjunction  with  PCOM  to 
retrieve  all  names  of  a particular  name  type  (such  as 
INTERFACE)  to  be  used  as  input  *o  the  PCOM  command.  For 
example: 


NAME-GEN  S = * TNTEF FACE  * 

PCOM  DESCRIPTION 

This  procedure  retrieves  all  INT2F  FACE  names  defined  in  the 
data  base  and  produces  ♦•he  PUNCHED  COMMENT  FNTFISS  report 
for  all  these  names  and  their  oorrespordinq  DESCRIPTIONS. 
This  could  also  be  done  for  more  than  one  type  of  name: 

NAME-GEN  S='SET  OF  PROCESS' 

PCCN.  DFSCPIPT  ION  PROCEDUFF 

Notice  that  the  PROCEDUFE  parameter  is  qiven,  but  SETS 
cannot  have  PROCEDURE  statements  associated  with  them. 

Only  the  DESCRIPTION  statements  will  be  retrieved  for  SFT 
names  while  both  DESCRIPTION  and  PROCEDURE  statements  will 
be  retrieved  for  PFOCFSS  names. 


mass 

The  problem  definer  should  note  that  most  ot  the  parameters 
indicating  comment  types  (i.e.,  FA  LCE- WHILE , V01ATILITY,  etc.) 
can  apply  to  only  one  type  of  name  (CONDITION,  Entity, 
respectively) . 


7.7  mm  .urn 

aafllt.teaUaa  flsis 

The  RENAME  command  takes  an  old  name  (of  some  object  in  the 
problem  statement  data  base)  and  a new  name  as  input.  If  the 
new  name  is  not  a UFL  reserved  word  or  a name  already  in  the 
data  base,  the  command  will  replace  the  old  name  by  the  new 
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name.  Before  a name  is  changed,  nr  A checks  that: 

- the  old  name  exists  in  the  data  base. 

- the  new  name  is  not  already  used  in  the  data  base. 

- the  new  name  is  a legal  URL  name  (see  the  "User  Requirements 
Language,  Version  3.3  Language  Reference  Manual").* 

If  any  of  these  requirements  are  violated,  no  change  will  be 
made. 


Output  Description 

The  output  generated  from  this  command  is  called  the  RENAME 
REPORT.  For  every  name  changed  hy  the  RENAME  command,  this 
report  presents  the  "old  name"  which  appeared  in  the  data  base 
and  the  "new  name"  which  has  taken  its  place.  When  the  natip 
change  is  not  successful,  error  diagnostics  are  also  printed 
specifying  the  cause  of  th^  error.  Again,  the  names  are  printed 
on  the  output  in  the  same  order  as  they  are  read  as  input. 


Execution 

To  change  one  name  in  the  data  base,  the  following  command  might 
be  given: 

RENAME  OLD=employee- identification- number  NEW=em plovee- id 
Upon  first  defining  the  target  system, 

"employee-identification-number"  was  used  to  represent  a certain 
piece  of  data.  Later  it.  was  found  that,  this  data  was  actually 
called  "employee- id"  and  the  change  was  made  to  be  consistent 
with  organization  terminology.  See  Figure  1b  for  the  report 
generated  by  this  command.  This  command  is  also  beneficial  for 
changing  misspelled  names  in  the  data  base.  Through  typing 
errors,  "employee-number"  may  have  gon-_  in  as  "emplyee-nuber". 
This  mistake  can  be  corrected  by: 

FENAME  OLr=emplyee-n uber  NEW=emplovee-nuraber 


Options  and 


Alternatives 


As  with  most  of  the  mo 
the  option  of  changing 
name  pairs  must  first 
the  command.  (This  is 
Pigure  17  presents  the 
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Each  line  of  the  fil»  must  consist  or  an  old  name  followed  by 
the  corresponding  new  name.  The  two  names  may  be  anywhere  in 
the  first  3*5  columns  of  the  line  and  must  be  separated  by  one  or 
more  blanks.  The  format  of  the  file  used  to  produce  Figure  17 
is  given  below: 

employee- in tormation  paysystem- inputs 

employee  personnel 


Common  Errors 

The  most  common  error  in  using  F E N AM  E is  specifying  a name 
already  ir.  the  data  base  or  a URL  reserved  word  as  the  new  name. 
URA  will  not  make  the  change  if  this  is  the  case.  The  command 
would  have  to  be  reissued  with  another  new  name  to  take  the 
place  of  the  illegal  one. 

If  neither  an  input  tile  or  an  OLD/NEw  pair  of  parameters  is 
specified  for  the  command,  the  message:  "MUST  GIVE  OLD  AND  NEW, 
OP  INPUT"  will  be  printed  by  UFA.  Should  this  happen,  URA  will 
not  execute  the  RENAME  command.  The  command  and  its  parameters 
should  be  reentered  with  the  necessary  corrections. 


7.8  jSIjJLACS^CdKM^N^iXIiil  S£££HL 


Modification  Made 

This  command  takes  as  input  names  which  exist  in  the  data  base, 
each  followed  by  a UPL  comment  entry  statement.  If  the  comment 
is  a DESCRIPTION  comment  entry,  for  example,  then  the  command 
will  replace  the  old  DESCRIPTION  comment  entry  by  the  one  used 
as  input.  What  RCOM  actually  does  is  delete  the  old  comment 
entry  and  put  the  new  comment  entry  in  its  place.  This  is  done 
after  a check  has  been  made  to  ascertain  that  the  "old  comment 
entry"  exists  in  the  data  base  and  the  "new  comment  entry"  is 
legal  for  the  particular  application  being  used  (e.g.,  not 
attempting  to  enter  a PROCEDURE  comment  entry  for  a SET  name). 

A check  is  made  to  see  if  the  input  name  is  in  the  data  base. 

Ir  an  attempt  is  made  to  replace  a comment  entry  for  a name  that 
did  not  have  a comment  entry  specified  for  it,  the  message: 

UFA126 : rtPSET:  WAFNING  - THERE  IS  NO  COMMENT  FNTFY  TO  DELETE 

will  be  given  and  the  designated  comment  entry  will  be  connected 
to  the  name. 


Output  Description 

The  output  generated  by  this  report  is  called  F EPLACFD  COMMENT 
ENTRIES.  For  each  "old  comment  entry"  to  be  replaced,  the 
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output  depicts,  in  the  following  order: 

- name  to  which  the  "old  comment  entry"  belongs. 

- the  type  of  comment  entry  which  is  being  changed. 

- the  entire  text  of  the  "old  comment  entry." 

- the  entire  text  of  the  "new  comment  entry"  which  replaces  the 
old  one. 

Error  diagnostics  referrinu  to  problems  encountered  in  executing 
the  command  are  also  printed  her^. 


Execution 

Any  information  to  be  supplied  as  incut  to  FCOI*  must  first  be 
placed  in  a file  and  the  tile  must  be  designated  as  input.1 
(This  is  usually  done  via  the  INPUT  parameter.) 

The  contents  of  the  file  must  be  in  the  following  format: 

name 

comment  entry  type; 


comment  entry 


etc. 

The  contents  of  the  file  used  to  produce  the  output  shown  in 
Figure  18  was: 


new-employee-processinq 
DESCRIPTION  ; 

This  process  produces  the  now  hire  section 
in  the  h-t  report . ; 
new-em pi oyee- processing 
PROCEDURE; 

1.  add  new  employee  information 

2.  increment  count  of  number  of  employees  in 
appropriate 

department 

3.  specify  relationship  between  employee  information 
and 

department 


1 The  exact  manner  ir.  which  the  file  is  specified  is  qiven  in 
Part  II,  Section  7.8. 
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4.  initialize  all  appropriate  fields  in  employee 
information. 

5.  print  the  new  hire  section  of  the  h-t  report.; 


Options  and  Alt  ernat  jves 

1)  It  is  often  the  case  that  only  some  minor  editinq  of  a 
comment  entry  reed  he  done  to  make  it  correct.  This  can  he 
done  when  *he  cu*-put  from  the  PUNCfh-COMM  F NT- ENTRY  command 
is  edited  and  used  as  input  to  the  FCOM  command.  This  is 
described  in  section  7.6  of  this  paper. 

2)  To  suppress  printing  of  *he  REPLACED  COM  KENT  ENTRIES  report 
the  NOPRINT  parameter  may  he  specified. 


Common  Errors 

The  major  problem  in  using  this  command  is  specifying  the  file 
format  correctly.  (This  is  not  a problem,  however,  if  the 
contents  of  the  filt  used  was  produced  by  PUNCH-COMKFNT-ENTRY . ) 
Althouqh  the  command  allows  free  formatting  of  the  file,  the 
order;  name,  comment-entry  type,  comment-entry  must  he 
maintained.  Each  must  begin  on  a new  line. 


8.  REPORT  COMMANDS 


Report  Commands  retrieve  specific  ♦■vpes  of  information  from  the 
data  base  and  present  it  ir.  formats  which  aid  the  problem 
definer  to  analyze  the  prohlem  statement  for  correctness  and 
completeness.  Many  of  the  formats  can  serve  as  final 
specifications  of  the  system  beinq  designed. 

Most  report  commands  allow  the  report  to  be  generated  for  a 
sinqle  name  (via  the  NAME  parameter)  or  for  a number  of  names 
placed  in  a file  and  specified  as  input  to  the  command.* 

The  descriptions  of  these  report  commands,  their  usaqe  and 
interpretation,  and  the  usage  of  reports  produced  by  them  are 
given  in  "UPA  Outputs. "* 


* The  exact  manner  in  which  this  is  done  is 
installation-dependent  and  is  qiven  in  Part  II,  Section  8. 

* Part  III 
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9.  EFFOK  DIAGNOSTICS 


UFA  has  extensive  chockinq  facilities  to  prevent  errors  in  the 
problem  statement.  At  the  UFA  command  mode  level,  checks  are 
made  to  insure  that  all  commands  given  are  legal  UFA  commands 
and  that  all  parameters  given  are  leqal  parameters  for  that 
command.  If  an  illegal  command,  an  illegal  parameter,  or 
illegal  parameter  tor  that  command  is  given  when  in  on-line 
mode,  the  following  message  will  he  generated: 

INVALID  PARAMETER  - 
ENTEF  REPLACEMENT  OH  BLANK  LINE 
■> 

The  user  must  enter  the  replacement  following  the  question  mark 
and  then  hit  the  carriage  return  key.  If  the  command  is 
accepted,  processing  or  that  command  commences.  Should  an  error 
be  encountered  while  processing  the  command,  one  of  the 
following  three  types  of  error  diagnostics  will  be  given: 


i)  Data  JJase  £&n axemen!  Rystem  Errors 

These  errors  are  encountered  when  there  may  be  some  danger  of 
destroying  the  contents  of  t he  UFA  data  base  or  there  is  an 
error  in  the  UFA  software.  Even  though  the  UFA  software  might 
be  the  cause  of  the  error,  it  is  doubtful  if  it  will  do  anything 
to  harm  the  contents  of  the-  user's  data  base.  A complete  list 
of  these  error  messages  is  given  in  "A  Data  Base  Management 
System  tor  UFA  Based  on  DBTG  71.” 

•**  FFFOF  16  - DATA  BASE  FILE  INCONSISTENT 

This  error  message  i;  jiven  if  the  user  attempts  t.o  modify  or 
retrieve  information  from  a UFA  data  base  which  has  had  its 
contents  altered  so  that  it  is  unusable  by  the  UFA  software. 

***  IFF  OR  * n FOUND  IN  ROUTINE  # m 

An  error  message  of  this  format  usually  designates  an  error  in 
the  UFA  software,  where  n is  the  error  number.  To  find  out 
which  routine  the  error  occurred  in,  refer  to  "A  Data  Base 
Management  System  for  UFA  Rased  on  DBTG  71.”  If  the  values  of 
the  variables  n and  m ar^  16  ar.d  1?  respectively,  the  error 
designates  a data  base  inconsistency  which  is  usually  a user 
error.  Any  other  enors  of  this  form  with  different  values 
should  be  brought  to  the  attention  of  those  persons  maintaining 
the  UFA  software. 
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ii)  £££°£s 

These  errors  are  encountered  in  the  processing  of  UFA  commands 
and  are  user  errors.  These  diagnostics  are  qenorated  when  the 
user  presents  ambiquous  or  incorrect  information  to  the  UFA 
commands.  In  most  cases,  UFA  will  take  no  action  to  fulfill  the 
user's  request  if  an  erro  is  encountered.  The  command  must,  be 
restated  in  corrected  fo;.i«,  before  action  is  taken.  All  these 
errors  are  presented  in  the  tollowinq  format; 

UFA nnn: subrout  ire;  error-message 

where  "nnn"  desiqnates  the  UFA  error  number,  "subroutine" 
denotes  the  subroutine  in  the  UFA  software  where  the  error 
occurred,  and  "error- messaqe"  corresponds  to  some  diaqnostics 
which  describe  the  error  condition. 


iii)  jim  mm  mam 

These  errors  are  encountered  when  the  INPUT-PSL  or  DELETE-PSL 
are  used  incorrectly.  UFA  always  attempts  to  recover  from  these 
errors  unless  an  excessive  number  of  errors  have  been 
encountered.  Each  of  these  errors  is  assigned  a level  number,  1 
through  4.  The  user  is  allowed  to  make  up  to  24  level  1 and  24 
level  2 errors,  but  a single  level  d or  level  4 error  will 
terminate  processing  of  the  command.  The  levels  are  described 
below. 


lijalS 

? 9 

Serious  user  error  24 

UFA  unable  to  recover  0 

Exceeded  UFA  capabilities  0 


J3$4;C£iPtipn 

This  statement  is  ignored 


These  types  of  errors  are  presented  in  the  following  format: 

♦***  LEVEL  j,  UF Ann n : subrout ine : error-message 

where  "-j"  designates  the  level  number  and  "nnn"  denotes  the  UFA 
error  number.  The  last  part  of  the  format  is  the  same  as  the 
URA  command  errors. 


1 

I 


After  processing  any  URA  command,  a STOP  status  message  is 
given.  This  message  designates  that  processing  of  the  command 
was  successful  (STOF  0,  i.e.,  errors  were  handled  effectively, 
etc.)  or  that  processing  was  not  totally  successful  (STOP  4 or 
STOP  8) . STOP  4 is  given  when  an  error  level  limit  is  exceeded 
for  INPUT-PSL  errors,  for  example.  The  STOP  8 message 
designates  a serious  error  in  attempting  to  access  the  data 
base,  usually  resulting  from  an  inconsistent  data  base. 


The  following  is  a list  of  all  possible  errors  that  can  be 
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encountered  while  usinq 
accompanies  it  as  well 
error  occur.  More  than 
explanation,  while  the 
error  is  recognized  in 


UFA.  A short  description  of  each  error 
as  suqqested  action  to  take  should  the 
one  error  may  have  a similar 
software  makes  a distinction  because  the 
different  places. 
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Nufibex  lubr2«itine 
2 NLEX 


3 NL^X 

4 INDBS 

5 N LEX 

6 SCAN 

7 SCAN 


Error  Message 
NAKF  TOO  LONG 

A user  defined  name  has  exceeded  the  30 
character  limit  allowed  by  URL/UFA.  The 
name  is  truncated  to  3G,  but  is  still  put 
in  the  data  base.  (See  section  10.1, 
part  v.) 

•EOF*  NOT  FOUND  BFFOFE  END-OF-FILE 
The  user  has  terminated  the  input  before 
specifying  the  UFL  'EOF*.  Processinq  of 
the  input  is  terminated. 

FEFOB  OPENING  DATA  BASE  FOR  - 

END- C F- FI IE  IN  KIDDLE  OF  COMMENT 
The  end  of  input  has  been  encountered 
follovinn  the  •/*'  comment  characters. 
Processinq  of  the  input  is  terminated. 

INVALID  LEXICAL  TYPE  PETUPNED  FROM  NLFX 
UFA  software  error.  Please  notify 
persons  maintaining  UFA  should  this  error 
occur . 

ILLEGAL  CHAPACTER  - IGNOPED 
An  illegal  character  encountered  when 
scanning  an  input  line.  See  the  "User 
requirements  Language,  Version  4.1) 
Languaqe  reference  Manual"  tor  a complete 
list  of  legal  characters.  The  illegal 
character  is  ignored  and  processing  of 
the  UFL  statement  continues. 


8 COMLOP 


9 PFOK 


10  REDUCE 


PARSE  STACK  CVEFFLOW 
UFA  software  error.  Please  notify 
persons  maintaining  UFA  should  this  error 
occur . 


BAD  CASE 

URA  software  error.  Please  notify 
persons  maintaining  UFA  should  this  error 
occu  r . 


NO  APPLICABLE  PRODUCTION  - SYNTAX  EFROF  - 
START  SKIPPING 

Illegal  UKI  statement  syntax  is 
encountered.  It  this  is  a header 
statement,  following  statements  will  be 
assigned  to  the  previous  header 
statement.  The  error  may  bo  a result  of 
incorrect  usage  of  a UFL  reserved  word, 
(Sec  section  it/.*,  pat  t i.) 
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11  STACK 


12  ISYMBL 

13  ISYMBL 

14  SErYPE 

15  STACK 

16  COM  ENT 

17  SKIP 

18  FETCH 

19  RECOV 

2t  FECOV 

21  SET  INF 


ILLEGAL  SYMBOL  PAIR  - SYNTAX  ERFOR  - 
STAFT  SKIPPING 

Illegal  UFL  statement  syntax  is 
encountered.  If  this  is  a header 
statement,  following  statements  will  be 
assigned  to  the  previous  header 
statement.  This  statement  is  not  entered 
into  the  UFA  data  base.  (See  section 
15.1#  part  i.) 

SYMBOL  TABLE  OVERFLOW 
Exceeded  limits  of  UFA.  Feissue 
INPUT-PSL  command  at  point  in  the  input 
file  where  this  error  occurred. 

TOO  MANY  SYMBOLS 

Exceeded  limits  of  UFA.  Reissue 
INPUT-PSL  command  at  point  in  the  input 
file  where  this  error  occurred. 

INVALID  SYMBOL  TABLE  POINTER 
URA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur. 

INVALID  CASE 

UFA  software  error.  Please  notify 
persons  maintaining  UFA  should  this  error 
occur. 

END-OF-FILE  IN  COMMENT  ENTRY 
Fnd  of  input  encountered  in  UFL  comment 
entry.  Processing  of  the  input  is 
terminated . 

END  OF  FILF  WHILE  SKIPPING 
Serious  error.  In  attempt  to  recover 
from  previous  errors  the  end  of  input  has 
been  encountered.  Processing  of  input  is 
terminated . 

PROCESS  HAS  NO  F ESOURCE  USAGE  - 

UNABLE  TO  FECOVEF  AT  "HIS  TIKE 
Processing  of  input  is  terminated  due  to 
serious  errors  which  make  it  unable  to 
continue . 

LAST  STATEMENT  SKIPPED 

Statement  where  error  occurred  is  skipped 
so  that  processing  of  input  may  continue. 

INVALID  SYMBOL  TABLE  POINTER 

URA  software  error.  Please  notify 
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23  UPDTRS 

24  MAINRCOM 

25  HEAD 


26  IGTYPE 
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persons  maintaining  UFA  should  this  error 
occur . 

SAKE  ATTR I BUTE  ALREADY  GIVEN  WITH 
DIFFEFENT  ATTPIBUTF  VALUE 
An  attempt  was  made  to  assign  a second 
value  to  the  same  ATTRIBUTE  for  a qiven 
name.  The  new  value  is  ignored. 

OVERFLOW  IN  FESOUFCE  STACK  — CONTINUING 

MISSING  SEMICOLON  ON  LINE  AFTER  NAME 
Semicolon  is  needed  to  terminate  comment 
entry  statement. 


1 


INVALID  HFADFP  STATEMENT  - STATEMENTS 
WILL  BE  IGNORED 

Illegal  syntax  of  header  statement.  All 
URL  statements  up  to  the  next  header 
statement  will  he  iqnored.  (This  error 
is  also  described  in  section  10. 1#  part 
iii . ) 

INVALID  SYMBOL  TABLE  POINTER 
UFA  software  error.  Please  notify 
persons  maintaining  UFA  should  this  error 
occur . 


27  PTA  BIN 


28  PTA  BIN 


29  MAINCT 


3P  UPDTPS 

31  MAINCT 


32  MAINCT 


INVALID  LEXICAL  TYPE  OF  END-OF-FILE 
UFA  software  error.  Please  notify 
persons  maintaining  UFA  should  this  error 
occur . 

DUPLICATE  RESERVED  WORD  - IGNORED 
UFA  software  error.  Please  notify 
persons  maintaining  UFA  should  this  error 
occur . 

CONFLICT  WITH  EXISTING  DATA  BASE 
CONNECTIONS 

Attempt  made  to  change  name  type  to  one 
which  conflicts  with  the  context  in  which 
the  name  is  used.  No  change  is  made. 

NO  MEASUFES  INFORMATION  FOR  RESOURCE  - 
BAD  INPUT  FORMAT 

The  format  of  the  file  used  as  innut  to 
the  command  is  incorrect.  See  the 
command  description  for  correct  format. 

No  change  is  made. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  change  name  type  of  name  not 


1 


1 
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33  MAINCT 


34  MAINCT 


3S  MAINCT 


3t  mainct 


37  UPD"RS 


38  MAINF2N 


39  KATNF2N 


I 

| 


detined  in  the  UFA  data  base. 

INVALID  NAME  TYPE 

Attempt  to  assign  an  illegal  name  type  to 
a name.  Probably  a spelling  error. 

NAME  TYPE  TOO  LONG 

Attempt  to  assign  an  illegal  name  type  to 
a name.  Probably  a spellinq  error. 

WARNING  - SI OFF  AFTEF  NAME  TYPE 
The  input  file  contains  more  than  -just 
name  and  new  name  type.  The  extra  data 
will  he  ignored  by  the  command  processor. 

INVALID  KANE  - IOO  LONG 

The  name  for  which  the  change  is  to  be 

made  is  over  30  characters.  Check 

spellinq. 

OVERFLOW  IN  INFORMATION  STACK  - 
CONTI NOING 

OLD  NAME  NOT  IN  DATA  3 ASE 
Attempt  to  change  name  of  some  object 
which  is  not  defined  in  the  data  base. 
Probably  a spelling  error. 

NEW  NAME  ALREADY  IN  DATA  RASE 
Attempt  to  change  old  name  to  a name 
already  defined  in  the  data  base.  User 
must  choose  another  name. 


4C  CLF.SN 


41  MAINDLL 


42  MAINDLL 


43  OTHERS 


44  0TUFF5 


MUST  GIVE  OLD  AND  NEW,  OF  INPUT 
Parameters  qiven  for  the  command  do  not 
supply  sufficient  information  for 
processing.  Reissue  command. 

NAhE  TO  PE  DELETED  NOT  IN  DATA  BASE 
Attempt  to  delete  a name  which  is  not 
defined  in  the  URA  data  base, 

INVALID  MFMEEF  TYPE 
URA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

CARDINALITY  ALREADY  GIVEN  AS  SYSPAR 
Attempt  to  assign  a numerical  value  to  a 
CARDINALITY  statement  when  previously 
assigned  a SYSTEM-PAFAKETER  name.  The 
value  is  ignored. 

CAFDINALITY  ALFEADY  GIVEN  AS  DIFFERENT 
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VALUE 

Attempt  to  assign  a second  value  to  a 
CARDINALITY  statement.  The  new  value  is 
ignored. 


CLCT 


NO  TYPE  GIVEN  WITH  "NAME="  OR  "FILE" 
PAFAMETEF 

No  new  name  type  has  been  specified.  The 
command  must  be  reissued. 


CT  TYPE,  BUT  NC  NAME  OF  FILE  GIVEN 

No  name  has  been  specified  to  have  its 
name  type  changed.  The  NAME  or  FILF 
parameter  must  be  given. 

PFERCA  INTERVAL  NOT  FOUND  IN  DATA  BASF  - 

PP2RCA  KEYWOPD  NOT  FOUND  IN  DATA  BASF  - 

ENUMF?  NO  NAMFS  IN  TAIA  BASE 

Attempt  to  retrieve  names  from  an  empty 
data  base. 

PLIST  TOO  MANY  NAMES  - BEST  IGNORED 

Exceeded  50  name  limit.  Femaining  names 
should  be  given  in  another  statement. 

PWLTST  MUST  BF  SUBSETTING  CRITERION  NAME 

Attempt  to  define  a name  which  is  not  a 
GROUP  or  FLENENI  to  be  SUPSETTING 
CRITERION . 

IDENTC  NAME  NOT  IN  DATA  BASE 

Attempt  to  retrieve  information  about  a 
name  which  is  not  defined  in  the  data 
base. 

OPTPW  NAME  LIST  TOO  LONG  - REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names 
should  be  qiven  in  another  statement. 

UPDTPF  PFOCESS  HAS  NO  PFOCESSOP  - 

UPDTPP  OVERFLOW  IN  PFOCESSOF  STACK  - MUST  ABORT 

UPDTPR  NO  HAPPENS  INFORMATION  FOP  - 

FETCH  SYSTEM  PARAMETER  HAS  NO  VALUF  - 

FNDRUP  NO  PFOCESSOF  INFOFM ATION  FOR  - 

PP E PRO  ROOT  PROCESS  NOT  FOUND  IN  DATA  BASF  - 

APPLES  SECOND  MAILBOX  FOR  PD  ILLEGAL 
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65 


66 


67 
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* Part 


Attempt  to  associate  a second  MAILBOX  to 
a particular  PROBLEM  DEFINER. 

PWLISI  ALREADY  PART  OF  SOMETHING  ELSE 

Attempt  to  define  a structure  where  an 
object  is  PART  OF  more  than  one  other 
object.  This  is  contrary  to  rules 
specified  in  the  "User  Requirements 
Language,  Version  3.3,  Language  Reference 
Manual . " 1 


R WL 1ST  SECOND  PD  FOR  THIS  ITEM  ILLEGAL 

Attempt  to  assign  a second  PESPONSIBLE- 
PROB LEM- DEFINER  to  an  object.  This 
statement  is  ignored. 


RWLIST  ALREADY  PART  OF  SOMETHING  ELSE 

Attempt  to  define  a structure  where  an 
object  is  PART  OF  more  than  one  other 
object.  This  is  contrary  to  rules 
soecified  in  the  "User  Reguirements 
Language,  Version  3.3,  Language  Reference 
Manual. "* 

MAINDICT  NAME  NOT  FOUND  IN  DATA  BASE 

Attempt  to  retrieve  information  about  a 
name  that  is  not  defined  in  the  data 
base . 


MAINCONT  NAME  NOT  FOUND  IN  DATA  BASE  - 

Attempt  to  retrieve  information  about  a 
name  that  is  not  defined  in  the  data 
base . 


MAIMPIC  NAME  NOT  IN  TATA  BASE 

Attempt  to  retrieve  information  about  a 
name  that  is  not  defined  in  the  data 
base. 


MAINPiC  PICTURE  NOT  AVAILABLE  FOF 

Attempt  to  generate  the  report  for  a name 
which  is  not  a SET,  INPUT,  OUTPUT, 

ENTITY,  GROUP,  ELEMENT,  PROCESS  or 
INTEFFACE.  Only  these  types  of  objects 
may  have  PICTURES  generated  for  them. 

REPSET  WARNING  - MISSING  SEMICOLON.  NEW  COMMENT 

ENTRY  ADDED 

Semicolon  not  given  to  terminate  comment 
entry.  One  is  assumed  and  processing 
continues . 


II  of  the  URI  User's  Manual. 
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REPSET 

NO  NEW  COM 
DELETED 
Since  no  n 
to  replace 
stat  ement 

MFNT  ENTRY  - OLD  ! 

ev  comment  entry  1 
the  old,  the  old 
is  deleted. 

ENTRY  HAS 

has  been 
comment 

BEEN 

given 

entry 

70 

CLDCCM 

NO  NAME  OP  PILE  SPECIFIED 

Either  the  NAME  or  FILE  parameter  must  he 
given  for  this  command  to  be  executed. 
Parameters  given  do  not  supply  sufficient 
information  for  processing.  Feissue 
command. 

71 

CLCT 

PARAMETER 

LEGAL 

ONLY  IN 

MTS 

VERSION 

- 

72 

CLCONT 

PARAMETER 

IFGAL 

ONLY  IN 

MTS 

VERSION 

- 

73 

CLNG 

PARAMETER 

LEGAL 

ONLY  IN 

MTS 

VERSION 

- 

74 

CLIP 

PARAMETER 

LFGAL 

ONLY  IN 

MTS 

VERSION 

- 

75 

CLFPS 

PARAMETER 

LFGAL 

ONLY  IN 

MTS 

VFRSION 

- 

76 

MAINPRIO 

NAME  NOT  IN  DATA  BASE 
Attempt  to  retrieve  informa 
name  that  is  not  defined  in 
base . 

tion  about  a 
the  data 

77 

CLDCOM 

PARAMETER 

LEGAL 

ONLY  IN 

MTS 

VERSION 

- 

78 

CLDEL 

PARAMETER 

LEGAL 

ONLY  IN 

MTS 

VERSION 

- 

79 

CLDICT 

PARAMETER 

LEGAL 

ONLY  IN 

MTS 

VERSION 

- 

80 

CLKWIC 

PARAMETER 

LEGAL 

ONLY  IN 

MTS 

VERSION 

- 

81 

CLPAV 

PARAMETER 

LEGAL 

ONLY  IN 

MTS 

VERSION 

- 

82 

CLPCOM 

PARAMETER 

LEGAL 

ONLY  IN 

MTS 

VFFSION 

- 

83 

CLPIC 

PARAMETER 

LEGAL 

ONLY  IN 

MTi 

VFRSION 

- 

84 

CLRCOM 

PARAMETER 

LFGAL 

ONLY  IN 

MTS 

VERSION 

- 

85 

CLP  EN 

PARAMETER 

LEGAL 

ONLY  IN 

MTS 

VFFSION 

- 

86 

CLSTP 

PARAMETER 

LEGAL 

ONLY  IN 

MTS 

VERSION 

- 

87 

CLDEL 

NO  NAME  OF 
Either  the 

given  for 

FILE 
FA  ML 
this  c 

WAS  SPECIFIED 

or  FILE  parameter  must  be 

:ommand  to  be  executed. 

Parameters  qiven  do  not  supply  sufficient 
information  for  processing.  Reissue 
comma  nd . 
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88 

MAIN  PR  10 

NAME  NOT  A PROCESS  NAME 

Attempt  to  retrieve  information  from  a 
name  that  is  not  a PROCESS  name.  Onlv 
PROCESS  names  may  be  used  as  input  to 
this  command. 

89 

PPOPE 

LOOP  IN  SUPPAFT/UTILIZES  STRUCTURE  AT  - 

9f 

R WL 1ST 

SSCS  IS  ONLY  LEGAL  TYPE  IN  DEFINE  SECTION 
WHICH  CAN  BE  MAINTAINED 

Attempt  to  use  MAINTAINED  statement  foi 
some  obiect  which  is  not 

SUBSETTING-CRITF FION. 

91 

ADDUSE 

TOO  MANY  USAGES 

UFA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

92 

MAINPAV 

NAME  NOT  IN  DATA  BASE 

Attempt  to  retrieve  information  about 
name  which  is  not  defined  in  the  data 
base . 

93 

MAIN  PA  V 

NAME  HAS  NO  USAGES  AS  ATTFIBUTE  FOR 
ANYTHING 

Attempt  to  retrieve  ATTFIBUTE  information 
for  a name  which  is  not  an  ATTRIBUTE. 

oa 

INPA? 

COMMANDS  IN  INCORRECT  SEQUENCE 

95 

CL  El 

MUST  GIVE  EITHEF  ENTITY  OF  IDFNTIFIFP 
PARAMETER 

Either  the  ENTITY  or  IDENTIFIER  parameter- 
must  be  used  in  conjunction  with  this 
command  for  successful  implementation. 

°6 

MAINSAVF. 

W R 1 1 - ERROR  - DATA  BASF  NOT  SAVED 

<57 

MAI  NS A Vi 

DA i A BASE  NOT  SAVED  - FILE  CANNOT  BE 
EMPTIED  - 

98 

CO'!  CO  L 

NAME  NOT  IN  DATA  BASE 

Attempt  to  retrieve  information  about  a 
name  not  defined  in  the  data  base. 

99 

IDENTR 

NAME  NOT  IN  DAI  A BASE 

Attempt  to  retrieve  information  about  a 
name  not  defined  in  the  data  base. 

IK 

NLIST2 

TOO  MANY  ATTRIBUTE  VALUF  PAIRS  IN  SINGLF 

STATEMENT 

Limit  exceeded.  Remaining  pairs  should 
'be  given  it)  another  statement. 
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Id  NLIST2  NAKF  ALREADY  USED  IN  DIFFERENT  CONTEXT 

Attempt  to  use  a name  defined  as 
something  else  as  an  ATTRIBUTE  name. 

1C2  NLIST2  NAME  ALPFADY  USED  IN  DIFFERENT  CONTEXT 

Attempt  to  use  a name  defined  as 
something  ®lse  as  an  ATTRIBUTE- VALUE 
name . 


103  DELSET  DESCRIPTION  COMMENT  ENTFY  NOT  FOUND  FOR: 

Attempt  to  delete  a nonexistent 
DESCRIPTION  statement. 


104  DELSET  PROCEDURE  COMMENT  ENTRY  NCI  FOUND  FOF : 

Attempt  to  delete  a nonexistent  PROCEDURE 
statement . 


1C  5 DFLSET 


1C  6 DELSET 


137  DELSET 


108  DELSET 


109  DELSET 


VOLATILITY  COMMENT  NOT  FOUND  FOF: 

Attempt  to  delete  a nonexistent 
VOLATILITY  statement. 

VOLATILITY- MEMBER  COMMENT  ENTRY  NOT  FOUND 
FOR: 

Attempt  to  delete  a nonexistent 
VOLATILITY-MEMBER  statement. 

VOLATILITY*  SET  COMMENT  ENTRY  NOT  FOUND 
FOR: 

Attempt  to  delete  a nonexistent 
VOLATILITY- SFT  statement. 

DERIVATION  COMMENT  ENTRY  NOT  FOUND  FOP: 
Attempt  to  delete  a nonexistent 
DERIVATION  statement. 

TRUE  WHILE  COMMENT  ENTFY  NOT  FOUND  FOP: 
Attempt  to  delete  a nonexistent  TRUF 
WHILE  statement. 


11C  DELSFT  FALSE  WHILF  COMMENT  NOT  FOUND  FOR: 

Attempt  to  delete  a nonexistent  FALSE 
WHILE  statement. 


V 


111  MAIN  DCOM 

112  PUNSET 

113  CLCM 


NAME  NOT  FOUND  IN  DATA  BASE 

Attempt  to  delete  information  for  a name 

not  defined  in  the  data  base. 

NO  DESCRIPTION  AVAILABLE  FOR  : 

MUST  GIVE  EITHER  CONSISTS  OR  CONTAINED 
PAR AMETSF 

Either  the  CONSISTS  or  CONTAINED 
parameter  must  be  used  in  conjunction 
with  this  command. 


a 
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be 


in  VLIST 


115  VLITT 


116  CTHFFS 


117  OTHERS 


118  CLFCA 


IIS  CLP  CA 


120  iNAMET 


121  MAINFCOM 


122  MAINFCOM 


123  MAI  NFC CM 


ONLY  SINGIF  VALUE  OF  RANGE  ALLOWED  - 
IGNORED 

Invalid  format  tor  specifying  a VALUES 
statement.  See  the  "User  Reguiremen ts 
Language,  Version  3.3,  Language  Reference 
Manual. "> 

MIN  NOT  LF.SS  THAN  MAX  - IGNORED 
If  a number  range  is  specified  the  first 
number  must  he  less  than  the  second 
number. 

VALUES  ONLY  LEGAL  FOB  ELEMENT,  SYSPAT,  or 
ATTRIBUTE- VALUE 

Attempt,  to  use  a VALUES  statement  for  a 
name  which  is  not  an  ELEMENT, 
SYSTEM-PARAMETER  or  ATTE IBUTE- V A LU E . 

DIFFERENT  VALUES  ALFEADY  GIVEN 
Attempt  to  assign  a second  value  for  a 
given  object.  This  statement  is  ignored. 

FILL=  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 
Error  encountered  in  using  a 
SYSTFM-PAF AMF.TEF  in  a given  statement. 
Interpretation  of  rest  of  statement 
becomes  confused. 

PUNCH*  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 
Attempt  to  use  zero  as  a 
SYSTES-PAF AMFTEF . 

NAME  ALREADY  USED  IN  DIFFERENT  CONTEXT 
Attempt  to  use  a name  in  a context  which 
conflicts  in  the  way  it  has  previously 
been  used. 


NAME  NOT  FOUND  IN  DATA  BASE 

Attempt  to  access  information  for  a name 

not  defined  in  the  data  base. 

INVALID  TYPE  OF  COMMENT  ENTRY 
Attempt  to  replace  unrecognizable  comment 
entry  statement.  Probably  a spelling 
error . 

CANNOT  HAVE  THIS  lYTL  OF  COMMENT  ENTFY 
Attempt  to  assign  a comment  entry 
statement  which  is  not  legal  for  the 
particular  name  type. 


1 Part  it  of  the  UFI  User's  Manual. 
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124  REPSET 


125  MAINRCOM 


126  REPSET 


127  PUN  SET 


128  PUNSET 


129  PUNSET 


13C  PUNSET 


...WITH  THIS  NAME 

Used  in  conjunction  with  URA123. 

Specifies  the  name  for  which  the  comment 
entry  was  used. 

PROBLEMS  SCANNING  INPUT  FILL  - MUST  ABORT 
Incorrect  format  of  tile  used  for  input. 
See  command  description  for  correct 
format. 

WARNING  - THERE  IS  NO  COMMENT  ENTRY  ’’'O 
DELETE 

Attempt  to  delete  nonexistent  comment 
entry . 

DESCRIPTION  COMMENT  ENTRY  NOT  FOUND  FOR: 
Attempt  to  retrieve  nonexistent 
DESCRIPTION  statement. 

PROCEDURE  COMMENT  FNTRY  NOT  FOUND  FOP: 
Attempt  to  retrieve  nonexi stent  PROCEDURE 
statement . 

VOLATILITY  COMMENT  NOT  FOUND  FOF : 

Attempt  to  retrieve  nonexistent 
VOLATILITY  statement. 

VOLATILITY-MEMBER  COMMFNT  ENT F Y NOT  FOUND 
FOR: 

Attempt  to  retrieve  nonexistent 
VOLATILITY-MEMBER  statement. 


131  PUNSET  VOLATILITY-SET  COMMENT  ENTRY  NOT  FOUND 

FOR  : 

Attempt  to  retrieve  nonexistent 
VOLATILITY -SET  statement. 


132  PUNSET 


133  PUNSET 


134  PUNSET 


DERIVATION  COMMENT  FNTFY  NOT  FOUND  FOR: 
Attempt  to  retrieve  nonexistent 
DERIVATION  statement. 

TRUE  WHILE  COMMENT  ENTRY  NOT  FOUND  FOF: 
Attempt  to  retrieve  nonexistent  TFUE 
WHILE  statement. 

FALSE  WHILE  COMMENT  NOT  FOUND  FOF: 
Attempt  to  retrieve  nonexistent  FALSE 

WHILE  statement. 


135  MAINPCOM  NAME  NOT  FOUND  IN  DATA  BASE 

Attempt  to  retrieve  information  for  a 

name  not  defined  in  the  data  base. 
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136  PELNT 

137  MAINVAL 

138  KATNVAL 

1.39  KAINVAL 

lU''  MAIN  DP 

141  CON  ROW 

142  CLRCA 

143  MAINDP 

144  DPCOL 

1 4 f>  DPCOL 

146  DPCOL 

147  DPROW 

148  DPHOW 


NO  ELEMENTS  SATISFY  THE  REQUESTED 
ATTFIBUTE-VALUES 


NAMF  NOT  IN  DATA  BASE  - 

NAME  IS  NOT  AN  ATTRIBUTE  OF  IT  HAS  NO 
VALUE  - 

NO  NAMES  IN  DATA  BASE 

VALUE  OF  KM  IS  GREATER  THAN  THE  NUMBER  OF 
MANP.ATTF.  - IGNORED 


NAME  NOT  IN  DATA  BASE 

Attempt  to  retrieve  information  for  a 
name  not  defined  in  the  data  base. 


EMPTY  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 
Attempt  to  delete  a relationship,  between 
two  names,  which  is  not  defined  in  the 
data  base. 


NAME  NOT  IN  DATA  BASE 

Attempt  to  retrieve  information  about  a 
name  which  is  not  defined  in  the  data 
base. 


TOO  MANY  COLUMNS 

Exceeded  limits  of  the  software  that 
produces  the  matrix.  Names  omitted  from 
the  matrix  should  be  used  as  input  to 
another  DP  command. 


TOO  MANY  POWS 

Exceeded  limits  of  the  software  that 
produces  the  matrix.  Names  omitted  from 
the  matrix  should  be  used  as  input  to 
another  DP  command. 


SPARSE  MATRIX  SYSTEM  OVERFLOW 
Exceeded  limits  of  the  software  that 
produces  the  matrix. 


TOO  MANY  ROWS 

Exceeded  limits  of  the  software  that 
produces  the  matrix.  Names  omitted  from 
the  matrix  should  be  used  as  input  to 
another  DP  command. 


TOO  MANY  COLUMNS 

Exceeded  limits  of  the  software  that 
produces  the  matrix.  Names  omitted  from 
the  matrix  should  be  used  as  input  to 
another  DP  command. 
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149  DPROW 


15C  DPSUM 


151  DPSUK 


152  DPSUK 


153  MAINDP 


154  MAINDP 


155  DPSUM 


SPARSE  MATFIX  SYSTEM  OVEFFLOW 
Exceeded  limits  of  the  software  that 
produces  the  matrix. 

NO  F0W3 

No  relationships  can  be  specified  about 
the  names  used  as  input,  so  no  matrix 
will  be  generated. 

NO  COLUMNS 

No  relationships  can  be  specified  about 
the  names  used  as  input,  so  no  matrix 
will  be  generated. 

SPARSE  MATFIX  SYSTEM  OVEFFLOW 
Exceeded  limits  of  the  software  that 
produces  t. hp  matrix. 

INVALID  INPUT  NAME  TYPE 

Attempt  to  use  a name  which  is  not  a 

PROCESS  name  as  input  to  the  command. 

INVALID  INPUT  NAME  TYPE 

Attempt  to  use  a name  which  is  not  a SET, 
INPUT,  OUTPUT,  ENTITY,  GPOUP  or  ELEMENT 
name  as  input  to  the  command. 

INVALID  FOW  ^YPE  - SYSTEM  ERROR 
UFA  software  error.  Please  notify 
persons  maintaining  UFA  should  this  error 
occur . 


156  CLRCA  NO  INTEFVAL  GIVEN  - MUST  ABORT 

Attempt  to  delete  a relationship  which 
has  not  been  defined  in  the  data  base. 

157  CLRCA  N BP  AND  NBF  NOT  ALLOWED  TOGETHER  - MUST 

ABORT 

Attempt  to  delete  a relationship  which 
has  not  been  defined  in  the  data  base. 

158  DBTCON  NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which 
has  not  been  defined  in  the  data  base. 

159  DBTCON  NAMES  NOT  CONNECTED  IN  THAT  FASHION 

Attempt  to  delete  a relationship  which 

has  not  been  defined  in  the  data  base. 

160  UDDERS  NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which 
has  not  been  defined  in  the  data  base. 
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lol  UDDERS 


162  UDDERS 


163  PFTPR 


16<*  PRTRS 


165  UPDTPh 


166  UDDERS 


167  UDDERS 


168  UDDERS 


169  ADJINT 


17’'  ADJINT 


171  DELSYN 


172  DELSYN 


NO  CONNECTIVITY  EXISTS 

Attempt  to  delete  a relationship  which 

does  not  exist  for  this  name. 

DIFFERENT  CONNECTIVITY  IN  DATA  BASE  - NOT 
DELETED 

Attempt  to  delete  a relationship  which  is 
not  stated  exactly  as  it  is  in  the  data 
base. 

NO  PROCESSOR  INFORMATION  FOUND  IN  DATA 
DASF 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


NO  PROCESSOR  INFORMATION  FOUND  IN  DATA 
BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

SYSTEM  PARAMETER  WITHOUT  VALUE  - 
Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


DIFFERENT  VALUES  IN  DATA  BASE-  NOT 
DFLETED 

Attempt  to  delete  a number  or  ranqe  of 
numbers  that  was  not  defined  for  the 
stat  eraent . 


HAFPFNS  INFORMATION  NOT  CONVERTIBLE  FOR 
THE  INTVL  - 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

SYSTEM  PARAMETER  WITHOUT  VALUE 
FNCOUNmEFFD  - 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


NAME  IS  NOT  A SYNONYM  FOP  THIS  NAME 
Attempt  to  delete  a SYNONYM  relationship 
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173  DPFPC 


174  DPFPC 


175  DRIVES 


176  DRIVES 


177  DRIVES 


178  DHAPNS 


179  DPFPC 


18C  DHAPNS 


181  DISCON 


182  DISCON 


which  is  not  defined  in  the  data  base. 

"USING"  INFO  NOT  IN  DATA  BASE. 

Attempt  to  delete  a relationship  which  is 
not  exactly  as  it  is  in  the  data  base. 


WARNING  - "USING"  INFO  IN  A DATA  BASE. 
"USING  Clause  not  included  although 
section  object  has  using  parts.  All 
"USING"  parts  have  been  deleted. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAK2  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


THESE  TWO  NAMES  NOT  CONNECTED  IN  THAT  WAY 
Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


"USING"  NAME  NOT  IN  DATA  BASK. 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


NAMES  NOT  CONNECTED  IN  THAT  FASHION 
Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


183  DISCON  NAMES  NOT  CONNECTED  IN  THAT  FASHION 

Attempt  to  delate  a relationship  which  is 
not  defined  in  the  data  base. 

184  ATT V NAME  DOESN'T  HAVE  THIS  ATTRIBUTE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 
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185  ATT  V 

186  ATTV 

187  DCNSIS 

188  DCNSIS 

189  DCNSIS 

19C  DCNSIS 

191  DCNSIS 

192  PPERCA 

193  PFEPCA 

194  PFEPF.O 

195  MAIN  SECA 

196  PLONG 

197  COM  NT 


NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  HAS  NO  ATTRIBUTES 

Attempt  to  delete  ATTRIBUTE  relationship  m 

for  a name  with  no  ATTRIBUTES. 


SYSPAF  VALUE  IN  DATA  BASE  IS  DIFFERENT  - 
IGNORED 

Attempt  to  delete  a statement  using  a 
different  SYSTEM- PAP AMETEF . Statement 
not  deleted. 

WARNING  - SYSPAn  IN  DATA  BASE 
Statement  deleted  though  user  did  not 
include  SYSTEM- PARAMETER  with  statement. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a CONSISTS  relationship 
using  a name  not  defined  in  the  data 
base. 

CONSISTS/CONTAINED  INFORMATION  NOT  IN 
DATA  BASE 

Attempt  to  delete  a CONSISTS  or  CONTAINED 
relationship  not  defined  in  the  data 
base . 

NO  SYSPAK  IN  DATA  BASE  - IGNORED 
Attempt  to  delete  a relationship  which  is 
not  defined  exactly  in  the  same  way  as 
defined  in  the  data  base.  Statement  not 
deleted . 

NAME  GIVEN  AS  KEYWORD  IS  NOT  A KEYWORD  - 
Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  GIVEN  AS  AN  INTVL  IS  NOT  A INTVL  - 
NAME  GIVFN  AS  PFOCESS  IS  NOT  A PROCESS  - 
NAME  NOT  IN  DATA  BASE  - 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

COMMENT  NOT  FOUND  ***SYSTFM  EFPOP  *** 

UFL  software  error.  PLease  notify 
persons  maintaining  URL  should  this  error 
occur. 

COXMENT-ENTFIES  NOT  ALLOWFD  IN  DPSL 
Attempt  to  delete  comment-entry 
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198  COMNT 


199  DHAPNS 


200  DHAPNS 


2C1  PLIST 


202  NLIST 


203  KATNSEC A 


statements.  This  can  only  be  done  usinq 
the  DCOM  and  FCOM  commands.  Statement 
not  deleted. 

EOF  WHILE  LOOKING  FOP  SEMICOLON 
Improper  statement  syntax  has  been 
encountered.  Semicolons  are  needed  to 
end  all  UFL  statements. 

DIFFERENT  SYSFAF  - NOT  DELETED 
Attempt  to  delete  a HAPPENS  relationship 
using  a different  SYSTEM-PAR AMETFR  than 
defined  in  the  data  base.  Statement  not 
deleted . 

INTERVAL  NOT  IN  DATA  BASE 
Attempt  to  delete  a HAPPENS  relationship 
using  an  INTEFVAL  not  defined  in  the  data 
base . 


NAME  NOT  PAF’r  OF  H FA  CEF 
An  illegal  statement  header  has  been 
given.  Probably  a spelling  error.  The 
statement  is  ignored. 

NAME  PREVIOUSLY  USED  DIFFERENTLY  - 
IGNOFED 

Attempt  to  use  a name  in  a context 
different  than  the  way  it  is  defined. 
(This  error  is  also  described  in  section 

^0.1.) 

INPUT  NAME  HAS  INVALID  TYPE 
Attempt  to  delete  a relationship  not 
defined  in  the  data  base. 


274  D5FN  N AMI  ALPFAOY  USED  IN  DIFF2FENT  CONTEXT 

Attempt  to  assign  a name  type  to  a name 
which  is  used  in  a different  context. 


205  SETSYN 


206  SETSYN 


2f  7 SET5YN 


208  MAINNLA 


ALPEADY  SYNONYM  FOP  SOMETHING  ELSE 
Attempt  to  assign  a name  to  be  a SYNONYM 

for  more  than  one  object . 

UNABLE  TO  MAKE  SYNCNYM  - TOO  COMPLICATED 
See  section  17.1,  part  vii  for 
explanation  and  solution  to  this  error. 

CANNCT  DE  MADE  SYNONYM  - DIFFEFENT  TYPES 
Attempt  to  assign  a name  as  a SYNONYM  to 
a different  name,  both  with  different 
name  types. 

NO  NAMES  IN  n ATA  BASE 
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2r9  CHKCON 


210  P FT NUN 


211  OTHEFS 


OTHEBS 


213  OTHEFS 


214  OTHEFS 


215  FWLTS2 


216  OTHEFS 


217  OTHEFS 


218  OTHEFS 


STACK  OVEFFLOW  WHILE  WALKING  CONSISTS 
STFUCTUFE 

Attempt  to  use  a name  which  is  not  an 
INTEFVAL  in  a CONSISTS  statement  for  an 
IN7LFVAL  section. 

NO  NAMES  IN  DATA  BASE 
Attempt  to  use  a name  in  a context 
different  than  the  way  the  name  is 
defined . 

NAME  MUST  EE  ENTITY  NAME 

Attempt  to  use  a name  in  a context  where 
only  an  ENTITY  name  is  acceptable. 

F ELATION  ALFFADY  EXISTS  BETWEEN  TWO  OTHFR 
ENTITIES 

Attempt  to  specify  the  same  RELATION  for 
a different  pair  of  ENTITIES.  Different 
ENTITY  pairs  imply  different  RELATIONS. 

CAN  ONLY  HAVE  ONE  CARDINALITY 
Attempt  to  specify  a second  CARDINALITY 
statement  for  a name.  Objects  may  have 
only  one  C AFDINALITY . 

CONNECTIVITY  ALREADY  GIVEN  FOR  THIS 
RELATION 

Attempt  to  specify  a second  CONNECTIVITY 
statement  for  a name.  RELATIONS  may  have 
only  one  CONNECTIVITY. 

ALREADY  CONTAINS  WITH  DIFFERENT  SYSTEM 
PARAMETER 

Attempt  to  specify  the  same  CONSISTS 
statement,  but  with  two  different 
SYSTEM-PARAMETERS. 

NAME  MUST  BE  ENTITY  NAME  BEFORE  VIA 
Attempt  to  use  a name  in  a statement 
where  only  an  ENTITY  name  is  allowed. 

NAME  MUST  BE  RELATION  AFTER  VIA 
Attempt  to  use  a name  in  a statement 
where  only  a RELATION  name  is  allowed. 

FELATION  ALFFADY  EXISTS  BETWEEN  DIFFERENT 
ENTITY  PAIR 

Attempt  to  specify  the  same  RELATION  for 
a different  pair  of  ENTITIES.  Different 
ENTITY  pairs  imply  different  RELATIONS. 
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221 

222 

223 

224 

225 

228 

229 

231 

232 

233 


CLSECA 


SETSYN 


NLIST 


CON  SUM 


RWLTS2 


OPTFW 


RWLIS7 


RWL 1ST 


P WL 1ST 


FWLIST 


APPLES 


DEFN 
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FILE  = NOT  ALLOWED  IN  THIS  IMPLEMENTATION 
Attempt  to  use  a name  in  a statement 
where  only  a CONDITION  name  is  allowed. 

CANNOT  MAKE  A NAME  FOP  ITSELF 
Attempt  to  specify  a basic  name  as  a 
synonym  for  itself.  Basic  names  cannot 
also  be  synonyms. 

TOO  MANY  NAMES  - PEST  IGNORED 
Attempt  to  specify  a list  of  names  for  a 
statement  where  only  a single  name  is 
acceptable . 

NAME  MUST  EE  AN  INTERVAL 
Attempt  to  use  a name  in  a CONSUMES 
statement  where  only  an  INTERVAL  can  be 
used . 


INCONSITENCY  IN  "HAPPENS  WITHIN" 
STATEMENT. 


Same  INTFFVAL  same  SECTION  different 
SYSPAF. 

NAME  MUST  BE  AN  ELEMENT  CE  CONDITION. 
Attempt  to  use  a name  in  a DEPENDING  ON 
statement  where  only  ELEMENTS  and 
CONDITIONS  may  be  specified. 

CANNOT  HAVE  KSYWOPD  FOP  KEYWOFD 

Attempt  to  assign  a KEYWOFD  to  a KEYWORD 

name. 

CANNOT  HAVE  SECUFITY  FOF  SECURITY 
Attempt  to  assign  a SECUFITY  statement  to 
a SECUFITY  name. 

CANNOT  HAVE  SOURCE  FOR  SOURCE 
Attempt  to  assiqn  a SOURCE  to  a SOUFCF 
name . 

SYNONYMS  ONLY  APPLIED  TO  FIRST  NAME 
Attempt  to  assign  a SYNONYM  to  more  than 

one  name.  The  SYNONYM  is  given  only  to 
the  first  name. 

APPLIES  STATEMENT  ILLEGAL  WITH  THIS  NAME 
TYPE 

Attempt  to  use  APPLIES  statement  for  a 
name  which  is  not  a KEYWORD,  MAILBOY, 
SECUFITY  or  SOURCE. 

TOO  MANY  NAMES  IN  DEFINE  HEADFP  - FEST 
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IGNORED 

Exceeded  50  name  limit,  remaining  names 
should  be  given  in  another  statement. 

234  OPTPW  NAME  ALREADY  USED  IN  DIFFERENT  CONTFX-' 

Attempt  to  use  a name  in  a wrong  context. 
Only  a PROCESS  name  can  be  used  in  this 
context . 


235  OPTION 

236  OPTION- 

237  DPFPC 


NAME  ALREADY  USED  IN  DIFFERENT  COHTFXT 
Attempt  to  use  a name  in  wrong  context 
for  an  UPDATES  relationship. 

NAME  LIST  TOO  LONG  - REST  IGNORED 

WARNING.  ''DEPENDING"  INFO  IN  A DATA 
BASE  . 

A depending  relationship  has  not  been 
specified.  ALL  depending  relationships 
have  been  deleted. 


238  DPFPC  WARNING . "FOR  EACH " INFO  IN  A DATA  BASE. 

A for  each  relationship  has  not  been 
snecified.  ALL  for  each  relationships 
have  been  deleted. 

239  DPFRC  NAME.  NOT  IN  DATA  BASE. 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


24C  APPLES 


241  APPLES 


242  QRO  PEN 


KEYWORD  CANNOT  APPLY  TO  KEYWOFD 
Attempt  to  use  the  AFPLIES  statement  in 
the  wrong  context. 


MAILBOX  CAN  ONLY  APPLY  TO  PD 

Attempt  to  use  the  APPLIFS  statement  in 

the  wrong  context. 


ATTEMPT  TO  OPEN  TOO  MANY  Q FILES  - SYSTEM 
SRFOR 


243  QWOPEN 


ATTEMPT  TO  OPEN  TOO  MANY  0 FILES  - SYSTEM 
ERROR 


244  INPAFA  COMMANDS  IN  INCORRECT  SEQUENCE 

245  GETS EC  ***  SYSTEM  ERROR 


246  APPLES  SECUFITY  CANNOT  APPLY  TO  SECURITY 

Attempt  to  use  the  APPLIES  statement  in 
the  wrong  context. 
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247  APPLES 

248  APPLES 

249  APPLES 

250  LIOFRE 

251  SNAHET 

252  SETSYN 

253  FWLIST 

254  NAM  CP 


255  SYNTH 

256  FWLIS'r 


SOURCE  CANNOT  APPLY  TO  SOURCE 

Attempt  to  use  the  APPLIES  statement  in 

the  wrong  context. 

MEMC  CANNOT  APPLY  TO  MEMO 

Attempt  to  use  the  APPLIES  statement  in 

the  wrong  context. 

INVALID  SECTION  - WOOPS 
URA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

***  SYSTEM  FFPOP 

ATTEMPT  TO  CHANGE  TYPE  WHEN  ALREADY  TYPED 
UPA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

SYNONYM  TABLF  OVZFFLOW 
Exceeded  UPA  limits.  The  user  should 
reissue  INPOT-PSL  command  at  point  in  the 
input  file  where  this  error  occurred. 

INVALID  STATEMENT  NUMBER 
UPA  software  error.  Please  notify 
persons  maintaining  UPA  should  this  error 
occur . 

***  SYSTEM  ERROR  ***  CANNOT  CREATE 
SYNONYM 

UPA  software  error.  Please  notify 
persons  maintaining  UFA  should  this  error 
occur . 

NUMBER  NOT  ALLOWED  AS  SYSPAF  THIS  VERSION 
CF  URA 

CONNECTION  ALREADY  EXISTS  WITH  DIFFERENT 
VALUE  OF  NAME 

UPA  software  error.  Please  notify 
persons  maintaining  UPA  should  this  error 
occur. 


257  FORKSL 

258  DPFPC 

259  DPFFC 


NAME  NOT  IN  DATA  BASE  - 
NAME  NOT  IN  DATA  BASE. 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

THESE  TWO  NAMES  NOT  CONN  FCTED  IN  THAT 
WAY. 

Attempt  to  delete  a relationship  which  is 
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26C  SORTKD 

261  DPFRC 

262  DPFFC 

263  RWLTS2 

264  PVLFT2 

265  F WL 1ST 

266  ILLS! 

267  ILLST 

268  RWLST2 

269  NLIS? 


not  defined  in  the  data  base. 

***  SYSTEM  ERROR 

"DEPENDING"  OF  "FOR  EACH"  NAME  NOT  IN 
DATA  DASZ. 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

"DEPENDING"  OF  "FOR  EACH"  INFO  NOT  IN  THF 
DATA  RASE. 

Attempt  to  delete  a relationship  which  is 
not  exactly  as  it  is  in  the  data  base. 
Relationship  is  not.  deleted. 

INCONSISTENCY  IN  "HAPPENS  AFTER" 
STATEMENT. 

Same  INTERVAL  same  SECTION  different 
SYSPAF 


INCONSISTENCY  IN  "HAPPENS  WITHIN" 
STATEMENT. 

Same  INTERVAL  same  SECTION  different 
SYSPAE  . 

CONNECTION  ALREADY  EXISTS  WITH  PIFFEFENT 
VALUE  OF  NAME 

Attempt  to  specify  same  relationship 
between  two  INTERVAL  names  though  with 
different  SYSTEM-PARAMETER.  Not  allowed. 

ILLEGAL  STATEMENT  IN  THIS  SECTION 
Attempt  to  use  a URL  statement  in  a wrong 
context.  See  "User  Requirements 
Language,  Version  3.3,  Language  Reference 
Manual" . 1 

NO  CUFRENT  SECTION 

Attempt  to  use  an  illegal  section  header 
statement.  See  "User  Requirements 
Language  Reference  Manual".1 

INCONSISTENCY  IN  "HAPPENS  AFTER" 
STATEMENT. 

Same  INTERVAL  same  SECTION  different 
SYSPAE  . 

NAME  LIST  TOO  LONG,  PEST  IGNORED 
Limit  of  5C  names  has  been  exceeded. 
Remaining  names  should  be  given  in 
another  statement. 


* Part  II  of  the  URL  User's  manual. 
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270  INPAR 


271  MAINCNO 


272  CNCBLD 


273  CNCBLD 


ERFOR  OPENING  DATA  BASE  - MUST  ABORT 
Attempt  to  use  an  inconsistent  data  base. 
No  processing  can  be  done  on  it.  (See 
section  10.1.) 

NAME  NOT  IN  DATA  BASE 

Attempt  to  retrieve  information  for  a 

name  rot  defined  in  the  data  base. 

TOO  MANY  FOWS  - STOPPING  HLFE 
Exceeded  limits  of  software  that  produces 
the  matrix.  Names  omitted  from  the 
matrix  should  be  used  as  input  to  another 
CNC  command. 

NAME  DOESN'T  CONSIST  OF  ANYTHING 
No  information  can  be  presented  for  this 
name  in  the  matrix. 


274  CNCBLD  TOO  MANY  LEVELS  - LOWER  LEVEL  STUFF 

IGNOFED 

Too  many  levels  of  CONSISTS  information 
to  be  presented. 

275  CNCBLD  ***THE  FOLLOWING  NAMES  ARE  INVOLVED  IN  A 

LOOP: 

This  problem  should  he  corrected  by 
modifying  the  CONSISTS  statements  for 
these  names. 


276  CNCBLD 


277  CNCBLD 


278  CNCBLD 


279  CNCSUN 


280  CNCSUM 


TOO  MANY  LEVELS  - LOWER  LEVEL  STUFF 
IGNORED 

Too  many  levels  of  CONSISTS  information 
to  be  presented. 

TOO  MANY  COLUMNS  - STOPFING  HERE 
Exceeded  limits  of  software  that  produces 
the  matrix.  Names  omitted  from  the 
matrix  should  be  used  as  input  to  another 
CONSISTS- COMPARISON  command. 

SPARSE  MATRIX  OVFFFLCW  - STOPFING  HERF 
Exceeded  limits  of  software  that  produces 
the  matrix. 

***N0  COLUMNS,  OF  NO  ROWS  - STOPPING 
No  relationships  can  be  specified  about 
the  names  used  as  input,  so  no  matrix 
will  be  generated. 

LESS  THAN  2 ROWS,  NO  SIMILARITY  MATPIX 
Not  enough  information  is  available  to 
generate  a matrix. 


I 
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UNCLASSIFIED 
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2fll 

282 

28  3 


2BU 


28  5 


286 


CNCSUK 


M US 


HAVE 


MAINSTP 


3FRPS 


FFINTV 
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SPARSE  MATRIX  OVERFLOW  - STOPPING 
Exceeded  Units  of  software  that  produces 
the  matrix. 

STACK  OVERFLOW  - CONTINUING 
Exceeded  Units  of  software  that  produces 
the  report.  An  attempt  is  nade  to 
recover  and  process  as  much  data  as 
possible. 

STACK  OVERFLOW  - CONTINUING 
Exceeded  limits  of  software  that  produces 
the  report.  An  attempt  is  made  to 
recover  and  process  as  much  data  as 
possihle . 

TOO  MANY  LEVELS  - CONTINUING 
Exceeded  limits  cf  software  that  produces 
the  report.  An  attempt  is  made  to 
process  as  much  data  as  possible. 

THE  FOLLOWING  NAMES  AFL  INVOLVED  IN  LOOPS 
Through  incorrect  specification  of 
PAHTS/SUEPAFTS  statements,  loops  have 
been  implied  in  structures  of  objects  in 
the  problem  statement.  The  user  should 
determine  which  PARTS/SUBPARTS 
relationships  should  be  changed  and 
delete  ♦•hem  via  the  DDLETE-PSL  command. 

NO  FREQUENCY  INFORMATION  IN  DATA  BASE 
No  HAPPENS  statements  have  been  specified 
in  the  problem  statement  stored  in  the 
data  base.  If  any  output  is  desired  from 
this  report,  at  least  one  HAPPENS 
statement  must  be  in  the  data  base. 


287  MAINIDX 


288 


STATPS 


289 


PCLFPT 


NO  NAMES  IN  INDEX 

Attempt  to  generate  an  index  into  a 
report  presenting  no  information  about 
any  names.  This  is  merely  a warning. 

NO  NAMES  AT  LEVEL  ONE 

Attempt  to  qenerate  STRUCTURE  report  for 
names  of  particular  name  type  (i.e., 
PROCESS,  INPUT,  OUTPUT  or  INTERFACE),  but 
no  names  of  this  type  currently  exist  in 
the  da^a  base.  To  generate  this  report 
for  PROCESS  names,  for  example,  at  least 
one  PROCESS  must  be  defined  in  the  data 
base . 

NO  PICTURE  AVAILABLE  FOE 

Attempt  to  qenerate  a PICTURE  for  names 
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which  legally  have  a PICTURE,  but  no 
information  that  was  specified  tor  this 
name  can  be  presented  in  PICTURE  format. 
Information  that  may  be  presented  in  a 
PICTURE  is  any  dealing  with  interaction 
of  data  and  PROCESSES  and  structure 
(CONSISTS  and  SUPPAFTF  statements). 


SF.TSYN 


INPDUM 


INPDUM 


MAINPR2S 


INPRES 


INPFFS 


ABPPES 


INPFES 


GFTDMC 


GFTPMP 


PUT PNG 


IDENTR 


IDENTF 


IDFNTR 


NAME  ALREADY  USED  IN  DIFFFRENT  CONTFX'r 
Attempt  to  assign  a name  of  UNDFFINFD 
name  type  as  a SYNONYM  to  another  name 
which  has  been  used  in  some  context  in 
conflict  with  the  manner  in  which  the 
UNDEFINED  name  has  been  used. 

ERROR  OFFN ING  DATA  BASF  FOR  - 

DATA  BASF  T F EMPTY 

INVALID  INPUT  CODF 

ERROR  OPENING  DATA  BASE  FOR  - 

DATA  BASF  FUST  UL  EMPTY 

******  RUN  ABORTED  ****** 

NULL  OF  INVALID  FIFS1  CAFD 

SEQUFNCF  ID  OUT  OF  OFDER 

SEQUENCE  IP  OUT  OF  OFDFF 

INVALID  FANGF  SPEC 

***TCO  MANY  COLUMNS  — MUST  STOP  HERE*** 
Exceeded  limits  ot  software  that  produces 

the  matrix.  Names  omitted  from  the 
matrix  should  be  used  as  input  to  another 
ENTITY- IDENTIFIER  command. 

***TOQ  MANY  — MUST  STOP  HFPF*** 

Exceeded  limits  cf  software  that  produces 

the  matrix.  Names  omitted  from  the 
matrix  should  be  used  as  input  to  another 
ENTITY-IDFNTIFIFF  command. 


*** MATRIX  QVFFFLOW  --  MUST  STOr  HEFF*** 
Excteded  limits  ot  software  t.ha*  produces 

the  matrix. 
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H4 


If  4 IDFN1Y 


3f  5 IDSNTC 


30*-  I DENTC 


Vi  ipfntc 


3>’b  idfntc 


3C'1  CON  ROW 


31 C CONROW 


311  CONROW 


3i r con  row 


313  CON  CO L 


Tilt,  FOLLOWIN''.  NAMES  DO  NOT  IDENTIFY 
ANYTHING: 

No  information  can  bo  presented  in  the 
matrix  tor  these  names  because  they  do 
not  "IDENTIFY”  any  ENTITIFb. 

♦♦•TOO  MANY  COLUMNS  — MUST  STOP  HEFF*** 
Exceeded  limits  ct  software  that  produces 
the  matrix.  Names  omitted  t tom  the 
matrix  should  be  used  as  input  to  trot  hot 
ENTITY- ICFN^IFifR  command. 

♦♦•TOO  MANY  FOWS  — MUM  STOP  H h'  F E ♦ * * 
Exceeded  limits  of  software  that  produces 
the  matrix.  Names  omitted  from  the 
matrix  should  be  used  as  input  to  another 
ENTITY- IDENTIKIT  R command. 

♦♦•MATRIX  OVERFLOW  — MUST  STOP  MEFF*** 
Exceeded  limits  of  software  that  produces 
the  matrix. 

Tile  FOLLOWING  NAMFS  ASF  NOT  IDENTIFIEP  UY 
ANYTHING: 

No  information  can  be  presented  in  the 
matrix  for  these  names  because  no 
"IDFNTIFIFD’*  relationships  have  been 
specified  for  them. 

••♦TOO  MANY  COLUMNS  — MUST  STOT  11 E F E • ♦ ♦ 
Exceeded  limits  of  software  that  produces 
♦he  matrix.  Names  omitted  t ion  the 
matrix  should  be  used  as  input  to  another 
CONSISTS- M ATF I X command. 

•*•-00  MANY  *0WS  — MUST  STOP  HERE** * 
'■'xceeded  limits  of  software  that  produces 
the  matrix.  Names  omitted  from  the 
matrix  should  be  used  as  input  to  another 
CONSISTS-M ATFIX  command. 

THE  FOLLOWING  ARE  NOT  CONTAINED  IN 
ANYTHING: 

No  information  can  bo  presented  in  the 
matrix  for  these  names  because  no 
"CONTAINFP  IN"  relationships  have  been 
specified  tor  thorn. 

* **M A TFT  X OVERFLOW  — MUST  STOF  H £ R F * * * 
Exceeded  limits  of  software  that,  produces 
this  matrix, 

♦•♦TOO  MANY  COLUMNS  --  MIST  STOP  HEFF*** 
Exceeded  limit:,  cf  software  that  produces 
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the  matrix.  Names  ouitted  fro*  the 
matrix  should  be  used  as  input  to  another 
CONS I STS- MATE  IX  command. 


314  CONCOL 


315  CONCOL 


316  CONCOL 


•♦♦TOO  MANY  FOWS  — MOST  STOT  H K F E • • * 
Exceeded  limits  of  software  that  produces 
the  matrix.  Names  omitted  from  the 
matiix  should  !>«  used  as  input  to  another 
CONSIST S-MATFIX  command. 

THE  FOLLOWING  DO  NOT  CONSIST  OF  ANYTHING: 
No  CONSISTS  statements  have  been  used  in 
coni  unction  with  the  names  listed. 

•♦♦MATFIX  OVFFFLOW  --  MUST  STOP  HEFF*** 
Exceeded  limits  cf  software  that  produces 
this  matrix. 


317  CHKPF.L  NAME  ALREADY  DSLP  IN  DIFFFPFNT  CONTFXT 


Attempt  to 

use  ,t  name  in  a 

context 

di f f erent 

from  its  initial 

context . 

316 

roots 

INVALIP  T 

CODF  - SYSTEM  EFFOF 

314 

R CO  P 5 

INVALID  T 

CCPF  - SYSTEM  ERROR 

320 

peon  5 

INVALIP  T 

CODE  - SYSTEM  EFROR 

321 

RC0P6 

INVALID  T 

COPE  - SYSTEM  FRROF 

322 

F CO  D6 

INVALIP  T 

COPE  - SYSTEM  EFROR 

323 

RC0T6 

INVALID  T 

COPE  - SYS1CM  FFROF 

324 

RCODfi 

HISSING  COPE  1C  CARP  - SYSTEM  EFFOF 

325 

CLCM 

FILL*  NOT 

ALLOWED  IN  THIS 

IMPLEMENTATION 

326 

CLCNC 

FILE*  NOT 

ALLOWED  IN  THIS 

IMPLEMENTATION 

327 

CLCONT 

FILE*  NOT 

A1 LOWED  IN  THIS 

IMPLEMENTATION 

326 

CLOT 

FILE*  NOT 

ALLOWED  IN  THIS 

IMPLEMENTATION 

329 

ClDCOM 

FILE*  NOT 

All  OWED  IN  THIS 

I M PI r MENTATION 

33C 

CLPEL 

KILE*  NOT 

AL1 OWED  IN  THIS 

IMPLEMENTATION 

331 

CLPICT 

FILL*  NOT 

ALLOWED  IN  THIS 

IMPLEMENTATION 

332 

CLDP 

FILE*  NOT 

ALLOWED  IN  THIS 

IMPLEMENTATION 

3 33 

CLDP 

MUST  GIVF 

DATA  01  PROCESS 

PAR AMLTFR 
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335 


34<= 

34b 

347 

348 
34  4 
35C 
351 


357 

758 

355 


CLCPSL 

CL~I 


CLP  COM 

CLREN 

CLFPS 

CLFPS 

CLNG 

CLPPIO 

CIPFIO 


CLPPIO 

FORMSL 

GETSLV 


INPUT  * NOT  ALLOWED  IN  THIS  IMPLEMENTATION 

F I L E = PAPAMFTFS  NOT  ALLOWED  IN  THIS 
IMPLEMENTATION 


336 

CLFPS 

FILE* 

NOT 

ALLOWED 

IN 

THIS 

IMPLEMENTATION 

337 

CLIP 

INPUT 

* NOT 

ALLOWED 

I 

N THIS 

IMPLEMENTATION 

338 

CLKWIC 

FILE* 

NOT 

ALLOWED 

IN 

THIS 

IMPLEMENTATION 

338 

CLNG 

EMPTY 

NOT 

ALLOWED 

IN 

THIS 

IMPLEMENTATION 

34f 

CLPCOM 

EMPTY 

NOT 

ALLOWED 

IN 

THIS 

IMPLEMENTATION 

341 

CLPAV 

FILE* 

NOT 

ALLOWED 

IN 

THIS 

IMPLEMENTATION 

342 

CLPCOM 

PUNCH 

= NOT 

1 ALLOWED 

I 

N THIS 

IMPLEMENTATION 

343 

CLP  IC 

FILE* 

NOT 

ALLOWED 

IN 

THIS 

IMPLEMENTATION 

344 

CLPRIO 

FILE* 

NOT 

ALLOWED 

IN 

THIS 

IMPLEMENTATION 

I NPUT * NOT  ALLOWED  IN  THIS  IMPLEMENTATION 
INPUT*  NOT  A I LOWED  IN  THIS  IMPLEMENTATION 
PUNCH*  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 
EMPTY  NOT  ALLOWc-D  IN  THIS  IMPEL  EM  ENT  ATI  ON 
PUNCH*  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 
PUNCH*  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 
EMPTY  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 


352 

RCOD1 

RAN 

OUT 

OF 

FOOM 

IN 

DATA 

BASE  - 

MUST 

ABOFT 

353 

RCOD3 

RAN 

CUT 

OF 

ROOM 

IN 

DATA 

BASE  - 

MUSI 

ABORT 

354 

RCOP4 

RAN 

OUT 

OF 

FCOK 

IN 

DATA 

BASE  - 

MUST 

ABOFT 

355 

FC0D5 

FAN 

OUT 

OF 

FOOM 

IN 

DATA 

BASE  - 

MUST 

ABOFT 

356 

RCOD6 

RAN 

OUT 

OF 

FOOM 

IN 

DATA 

BASE  - 

MUST 

ABOFT 

PUNCH  AND  EMPTY  PAFAMETEFS  NOT 
IMPLEMENTED  - IGNORED 


ILLEGAL  NAME  TYPE  FOR  FPS 
NO  NAKFS  IN  DATA  BASE 
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NAME  MUST  BE  ELEMENT,  RNYITY,  INPUT, 
OUTPUT,  GPOUP,  SET. 


WFONG  EOF MAT  FOF  A STATISTICS  FILE. 

Either  the  input  file  is  not  a Statistics 
file  or  it  is  in  the  wrong  format. 


EPS  UCC 


ROTH  FORWARD  AND  DACKWAFD  SPECIFIED. 
FOF  WARD  am!  BACKWAFD  are  conflicting 
parameters  and  only  one  should  be 
specified . 


MAI  NIC 


NAME  IS  NOT  AN  INTERVAL. 

The  name  given  as  input  to  the  report  is 
not  an  interval. 


INTSTF 


NO  MOPE  SPACE  FOP  ALLOCATING  NEW  TABLES. 
The  allocation  of  the  five  different 
arrays  needed  by  the  ?C  report  was 
impossible.  Restrictions  or  memory 
caused  this  error. 


• H 
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NAME  MUST  BE  ELEMENT  OP  CONDITION. 


362  UMU 


TOO  MANY  UNIQUE  ACCOUNT  NAMES  - PROGRAM 
NEEDS  MODIFICATION. 

There  are  too  many  Account-Project  names 
in  the  Statistics  file.  Notify  persons 
maintaining  the  UFA  software  if  it  is 
necessary  to  handle  this  many  Account 
names . 

WPONG  FORMAT  FOF  A STATISTICS  FILE. 

Either  the  input  file  is  not  a Statistics 
file  or  it  is  in  the  wrong  format. 


CTYCHIC 


MAI  NIC 


MAIN  DA 


MAINDA 


RAN  OUT  OF  SPACE  IN  TABLES. 

Too  many  different  interval  names  were 
encountered  in  the  structure  of  the  top 
interval  name.  Consistency  check  will 
not  be  performed  properly. 

NAME  NOT  FOUND  IN  DATA  BASE. 

NAME  NOT  IN  DATA  BASE  - 

Attempt  to  retrieve  information  about  a 

name  which  is  not  defined  in  the  data 

base. 

INVALID  NAMF  TYPE  - 

Attempt  to  use  a name  which  is  not  a 
PROCESS,  INPUT,  CONDITION,  or  EVENT  name 
as  input  to  the  command. 
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M2  BLD  MAT 


373  SUCOFS 


374  SUCOFS 


375  sucoas 


376  OASUM 


377  DASUM 


378  DASUM 


379  DAS0F7 


380  CO  R El  1 


381  CLEP 


_u  - ^ - ■ 
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Few  A PEA  OVERFLOWED. 

Exceeded  limits  of  the  software  that 
produces  the  matrix.  Input  names  omitted 
from  the  Matrix  should  be  used  as  Input 
to  the  next  DA  coimitnl. 

COLUMN  AREA  OVERFLOWED. 

Exceeded  limits  of  the  software  that 
produces  the  matrix. 

MATRIX  ROUTINES  OVEFELOW. 

Exceeded  Limits  of  the  software  that 
produces  the  matrix. 

STACK  CVEFFtOW. 

The  number  of  successors  for  the  input 
name  qiven  is  too  qreat.  This  is  a 
software  limitation. 

MATFIX  ROUTINES  OVERFLOW. 

Exceeded  limits  of  the  software  that 
produces  the  matrix. 

NO  ROWS  IN  MATRIX 

There  are  no  rows  in  the  matrix,  so  it 
will  not  be  qenerated. 

NO  COLUMNS  IN  MATRIX 

No  dynamic  relationships  can  be  specified 
about  the  names  used  as  input,  so  no 
matrix  will  be  generated. 

MATRIX  ROUTINES  OVERFLOW 

Exceeded  limits  of  the  software  that 

produces  the  matrix. 

STACK  OVERFLOW,  PICTURE  NOT  COMPLETE. 

The  number  of  successors  for  the  input 
name  qiven  is  too  qreat.  This  is  a 
software  limitation. 


PUNCH-NOT  ALLOWED  IN  THIS  IMPLEMENTATION 


382  R EL  4 

383  CLPC 

384  STNPUP 

385  MAINFFOP 


STACK  OVERFLOW,  PICTURE  NOT  COMPLETE. 
The  number  of  successors  for  the  input 
name  qiven  is  too  qreat.  This  is  a 
software  limitation. 

rUNCII*  NOT  ALLOWED  IN  THIS 
IMPLEMENTATION. 

STACK  OVIFFLOW  - SYSTEM  LIMITATION 
NO  VALID  NAMES. 


ft 


Part  I User  Requirements  Analyrer 


89 


TT 


- . - -i * 


UFA  User's  Manual 


¥ 


386  DOINTV 


387  FECBLD 


388  RECPLD 


389  CLPC 


390  CLPC 


391  FILMAT 

392  FILMAT 

393  FILMAT 


Either  no  interval  nates  exist  in  the 
data  base  or  no  interval  nates  with 
happens  relation  were  encountered  in  the 
data  base.  The  file  which  would  be 
sorted  is  empty. 

NO  HAPPENS  FELATION  FOR 

The  interval  name  does  not  contain  a 

HAPPENS  relation. 

NO  SYSTEM  PAFAKETEF  CONNECTED  TO 
The  HAPPENS  relation  tha*  exists  between 
an  interval  and  a name  does  not  contain  a 
system  narameter.  Check  that  the  input 
to  the  data  base  was  performed  properly. 

NO  EVENT  CON NFC TED  TC 

A HAPPENS  relation  of  the  type  WITHIN 
AFTEF.  or  AFTEF  does  not  contain  an  EVFNT 
connected  to  the  name  and  the  interval 
name.  Check  that  the  input  to  the  data 
base  was  performed  properly. 

HORIZONTAL  POXES  TOO  LAFGE  FOF  NUMBER  OF 
COLUMNS  ON  PAGE 

The  number  of  horizontal  boxes  specified 
will  not  fit  in  the  number  of  columns 
specified . 

VERTICAL  BOXrS  TOO  LARGE  FOF  NUMBER  OF 
ROWS  ON  PAGE 

The  number  of  vertical  boxes  specified 
will  not  fit  in  the  number  of  rows  per 
paqe  specified. 

NAME  NOT  IN  DATA  BASE  - 
NAME  NOT  EVFNT  OF  FROCESS 

SPARSE  MATRIX  TABLF  OVERFLOW,  PICTUFE  NOT 
COMPLETE 

The  process  chain  has  gotten  too  large 
for  the  software  to  handle.  This  is  a 
system  limitation,  and  to  resolve  this, 
the  number  of  links  must  be  decreased. 


I 

I 


394  REL1  STACK  OVERFLOW,  PICTUFE  NOT  CCKPLFTE 

The  number  of  successors  for  the  given 
input  name  is  too  great.  This  is  a 
software  limitation. 

395  FILMAT  LINK  LIMIT  SPECIFIED  WAS  REACHED 

This  is  not  so  much  an  error,  as  a note. 
To  obtain  a more  complete  process  chain 
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picture,  the  maximum  number  of  links  must 
be  increased. 

39t> 

CLEP 

HORIZONTAL  BOXES  TOO  LAFGE  FOF  NUKBFP  OF 
COLUMNS  ON  PAGE 

Thu  number  of  horizontal  boxes  specified 
conflicts  with  the  number  of  columns 
spec i f ied  . 

3 97 

CLEP 

VERTICAL  POXES  TOO  LAFGE  FOF  NUMBER  OF 
FOWS  ON  PAGF 

The  number  of  verticaL  boxes  specified 
conflicts  with  the  number  of  rows  per 
page  specified. 

39  8 

CLEP 

NEITUFF  DATA-FLOW  NO F STPUCTUFE  WAS 
SPECIFIED 

Either  DATA-FLOW  or  STPUCTUFE  must  be 
specified  (but  not  both) . 

399 

CLEP 

NEITHER  FORWARD  NOF  BACKWARD  WAS 

SPECIFIED 

Either  FORWARD  or  BACKWARD  must  be 
specified  (but  not  both) . 

400 

CLDA 

FILE  = PARAMETER  NOT  ALLOWED  IN  THIS 
IMPLEMENTATION. 

Attempt  to  use  illegal  parameter.  Check 
the  "User  Requirements  Analyzer  User’s 
Manual"  for  the  manner  in  which  a list  of 
names  may  he  specified  to  the  command. 

4C8 

CLEP 

NEITHER  UPWAPD  NOF  DOWNWAFD  WAS  SPECIFIED 
Either  UPWARD  or  DOWNWAFD  must  be 
specified  (but  not  both). 

409 

MAI N EP 

NAME  NOT  FOUND  IN  DATA  BASE 

41 C 

EPSHCC 

NAME  NOT  ACCEPTABLE  TYPE  FOR  EP  REPORT 

The  name  given  does  not  have  the  correct 
name  type  for  this  report.  The  possible 
name  types  are:  PPOCESS,  REAL  WORLD 
ENTITY,  INPUT,  ELEMENT,  GROUP,  OUTPUT, 
ENTITY,  SET,  UNDEFINED. 

411 

SPSMCC 

LINK  LIMIT  SPECIFIED  WAS  PEACHED 

This  is  not  so  much  an  error,  as  a note. 
To  obtain  a more  complete  Extended 
Picture,  the  maximum  number  of  links  must 
be  decreased. 

412 

EPSUCC 

SPARSE  MATRIX  TABLE  OVERFLOW,  PICTUFE  NOT 
COMPLETE 

Due  to  software  limitations,  the  Extended 
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Picture  could  not  be  completed.  To 
resolve  this,  the  maximum  number  of  links 
must  bo  decreased. 

413  FF.L2  STACK  OVEPFLOW,  PICTURE  NOT  COMPLETE 

The  number  of  successors  for  the  input 
name  qiven  is  too  great.  This  is  a 
software  limitation. 

414  REL’  STACK  OVEPFLOW,  PICTUFS  NOT  COMPLETE 

The  number  of  successors  for  the  input 
name  qiven  is  too  qreat.  This  is  a 
sottvaLe  limitation. 

415  CLEP  BOTH  DA'M-  FLOW  AND  STRUCTURE  SPECIFIED 

Fither  DATA-FLOW  or  STRUCTURE  must  be 
specified,  but  not  both. 

416  CLEP  CONFLICTING  FAi\  Af.ETEFS , FORWARD  AND 

BACKWARD  CF  UPWARD  AND  DOWNWARD 
Either  FORWARD  or  BACKWARD  must  be 
specified,  but  not  both.  The  same 
applies  to  UPWARD  and  DOWNWARD. 


417 

C1.PC 

FILE* 

SOT 

ALLOWED  IN 

THIS 

IMPLEMENTATION 

41  8 

CLEP 

FILE* 

NOT 

ALLOWED  IN 

THIS 

IMPLEMENTATION 

419  CFLTYP  INVALID  F.FI  A~ION  ^ YP  E FOP  PL  REPORT 

USA  Software  error.  Please  no*ity 
persons  maintaining  UPA  should  the  error 
occu  r . 

420  CLEP  DOTH  FORWARD  AND  DACKWAF  T SPECIFIED. 

FOFWARD  and  BACKWARD  are  conflicting 
parameters  an  1 only  one  should  be 
spec  if ied . 

421  CLEP  DOTH  THREAT  AND  DACKWAFE  SPECIFIED. 

THREAD  and  PACKWARD  are  conflicting 
parameters  and  only  one  should  be 
spec i f ied  . 

422  CLFP  NEITHER’  FORWARD,  THREAD,  NOR  FACKWAFD 

SPECIFIED. 

Either  FOPKARD,  THFEAD,  or  PACKWAFD  must 
be  specified. 

423  CLEP  BOTH  UPWARD  AND  DOWNWARD  SPECIFIED. 

UPWARD  and  DOWN  W A F P are  conflicting 
parameters  and  only  one  should  be 
spec i f ied  . 

424  CLFP  DOTH  STF  UCTUr  F ANI  THFEAD  SPECIFIED. 
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STR UCTUP L and  THREAD  are  conflicting 
parameters  and  only  one  should  be 
speci fled . 

425  CLSP  S Ell  HER  DATA-FLCW,  THREAD,  NOF  STKUCTUF  E 

SPECIFIED. 

Fither  DATA-FLOW,  THFFAT,  oi  STRUCTURE 
must  he  specified. 


428 

COM  ENT 

DATA  BASE 

OVEFFLOW 

42° 

COM  F W 

DATA  BASF 

OVERFLOW 

4 3C 

NAMCF 

TATA  BASE 

OVERFLOW 

431 

NUMCF 

DATA  BASF 

OVERFLOW 

479 

MAINCT 

WARNING  - 

EFFOFS  WERE  ENCOUNTERED 

481 

CLILCP 

INVALID  COMMAND  - 

493 

PCF 

ILLEGAL  A p ITHMET RIC  EXPRESSION. 

Arithmetic  expression  which  is  to  be 
parsed  does  not  meet  the  rules,  and/or 
logically  incorrect. 

494  PCF  ILLFGAL  OPEFATOR> 

There  is  an  operator  in  the  expression 
which  is  r.ot  legal  (i.e.,  not  specified 
in  the  user's  manual)  and  the  program 
does  not  understand  the  operation. 

495  PCP  non-numefjc  operand 

An  isolated  component  in  the  expression 
has  the  form  of  a leqal  UFA  name,  but  it 
is  neither  a system  parameter  nor  an 
attribute  in  the  data  base. 

496  PCF  NAME  DOES  NOT  HAVE  ATTRIBUTE 

An  isolated  component  i nthe  expression 
is  found  to  be  an  at tr ibute- name  in  the 
data  base  but  the  at tri bute-name  is  not 
specified  for  the  input  name. 

4<>7  PCF  ATTFIBUTE  DOES  NOT  HAVE  NUKFRIC  VALUE 

An  isolated  component  in  the  expression 
is  found  to  be  an  attribute-name 
soecified  for  the  input  name  but  the 
attribute-name  does  not  have  a numeric 
value  associated  with  it. 

409  ?CR  N PG  A TI VE  VAIUE  FOE  LN  CF  LOG 

LN  or  LOG  cannot  evaluate  negative 
values.  An  operand  or  an  arithmetic 
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F3DC0N 


F3DC0N 


APPLES 


RWLI3T 


ASSERT 


RWLIS2 


UN  AS  PT 


DOOPTR 


GET A TR 


GETNML 


NGEVAL 


NGPPS 


NGPFS 


NGPFS 


PPEPAF 


expression  in  the  braces  following  LN  or 
LOG  has  a negative  value. 


ZERO  DENOMINATOR . 

An  operand  following  the  operator  •/'  has 
the  value  of  7ero. 

NAME  NOT  FOUND  IN  DG  - 
The  name  for  which  the  arithmetic 
expression  is  to  be  evaluated  cannot  be 
found  in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

NAMLS  NOT  CONNECTED  IN  THAT  FASHION 

TRACE-KEY  CANNOT  APPLY  TO  TRACE- KFY 

CANNOT  HAVE  TFACE-KEY  FOR  TRACE-KEY 

TOO  MANY  TRIPLES,  FLST  IN  THIS  STMT 
IGNORED 

ALF.FADY  GIVEN  WITH  DIFFEFENT  ATTFIBUTF 
VALUE 

SAFES  NOT  CONNECTED 

UNBALANCED  PARENTHESES  IN  SELECTION 
STRING 

ATTFIBUTF  DOESN’T  APPLY  TO  ANYTHING 
There  are  no  names  which  have  the  given 
ATTRIBUTE. 


NO  NAMES  WHICH  MATCH  CPITEPION 

There  are  no  names  in  the  data  base  which 

satisfy  the  selection  criteria. 

*«*  SOFTVAFE  EPFOF 

NAME  ON  FIGHT  DOES  NOT  MATCH  TYPE  ON  LEFT 
INVALID  SELECTION  STPING 

The  selection  string  given  as  a parameter 
for  the  Name-Gen  report  is  not  a leqal 
boolean  expression. 

INVALID  ITEM  IN  SELECTION  STRING 

The  item  given  in  the  selection  string  is 

not  a legal  operand  or  a legal  operator. 

TOO  MANY  OP  Dr  P PAF  AMETEFS 

More  than  five  ORDER  parameters  have  been 
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PREPAF 


PPEPAR 


GET N MR 


NGPRS 


OPTKZ 


NGPPS 


CON  SM 


CON  SM 


RWLIS2 


FWLIS2 


PWLIS2 


FWLIS2 


IGKEY 


RWLIS2 
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qiven,  or  the  OFDEP  parameters  have  been 
qiven  incorrectly. 

NAME  IN  OF.DEF  LIST  NO  ATTRIBUTE 

The  name  qiven  in  the  order  list  is  not 

an  ATTRIBUTE. 

NAME  IN  OFDFP  LIST  NOT  IN  DATA  BASE 

NAME  IN  OFDEF  LIST  TOO  LONG 
The  name  qiven  has  more  than  30 
characters . 

NO  NAMES  WHICH  MATCH  CRITERION 

There  are  no  names  in  the  data  base  which 

satisfy  the  selection  criteria. 

***  SOFTWARE  ERROR 
***  SOFTWARE  ERROR 

TOO  MAN Y LEVELS , MAX  OF  5C  ALLOWED 
Too  many  levels  have  been  specified  via 
the  SUBPAPTS-OF  and  SUBLEVEL  paramter. 

NAME  MUST  BE  RESOURCE- USAGE-PARAMETER 

NAME  LIST  TOO  LONG  - PEST  IGNORED 

INCONSISTENCY  IN  CLASSIFICATION  STATEMENT 

INCONSISTENCY  IN  SECURITY- ACCESS-RIGHT 
STATEMENT 

INCONSISTENCY  IN  RESOU RCE- USAGE  STATEMENT 
INCONSISTENCY  IN 

FESOUPCE-USAGE-PARAMETEE-VALUE  STATEMENT 
SOFTWARE  ERROR  ***  SHOULD  NOT  OCCUR  *** 

INCONSISTENCY  IN  CONSUHES/CONSUMED 
STATEMENT 
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10.  HOW  TO  CORRECT  ERRORS 


Once  error  situations  <ire  detected,  there  must  he  sole  net  hod  to 
deal  with  the*.  when  the  errors  are  caused  by  problems  in 
generating  a report,  no  action  need  be  taken  as  no  hari  will 
come  to  the  data  base.  The  Report  Command  can  simply  be 
restated  in  correct,  format  to  solve  the  problem.  It,  however, 
an  error  is  encountered  in  makinq  modifications  to  the  data  base 
(via  Modifier  Commands)  then  some  immediate  action  should  be 
taken  if  the  problem  definer  desires  to  maintain  d correct  and 
complete  problem  statement. 

The  errors  discovered  in  making  modifications  to  the  data  base 
can  be  "Input  Errors"  which  are  errors  discovered  by  UFA  in  its 
attempt  to  process  the  information  needed  to  update  the  data 
base.  All  these  errors  are  specified  by  one  or  more  UFA  error 
messages.  The  ma-jority  of  these  errors  occur  in  the  process  of 
using  the  INPUT-PSL  command. 

The  errors  discovered  in  the  problem  statement  by  tin?  problem 
definer  are  called  "Logical  Errors."  No  error  diagnostics  are 
generated  by  UFA  to  denote  that  an  ertor  has  occurred.  If  a 
name  was  misspelled  in  the  input  information  used  for  INPUT-PSL, 
the  name  could  be  legal  by  UPL/UPA  conventions  yet  not  correct 
from  the  problem  definer* s standpoint.  "PATCH"  and  "PATUC"  are 
both  names  that  would  be  perfectly  acceptable  to  URA  but  not  to 
tho  problem  definer. 

The  following  two  sections  deal  with  aiding  the  problem  definer 
in  correcting  both  Input  Errors  and  Logical  Errors  should  they 
occur.  Treatment  of  the  error  correction  methodology  is  still 
at  a cursory  level  and  no  attempt  is  made  to  present  procedures 
to  correct  all  possible  ertots. 


10.1  Him 

As  stated  before,  all  input  errors  cause  URA  etror  diagnostics 
to  be  printed.  There  ire  a tew  classes  of  errors  which  happen 
again  and  again  and  so  will  be  described  below. 


I&£SJl£lS££Jl&  mill  i'SS* 

This  error  is  usually  identified  by  getting  the  URA  error: 
"UPA270 : INPAR:  ERROR  OPENING  DATA  PASE-KUST  APOFT. " This  error 
might  occur  after  issuing  a UFA  Modifier  or  Report  Command  and 
it  specifies  that  the  contents  of  the  tile  being  used  as  a ')PA 
data  base  cannot  be  accessed  by  the  URA  software.  Methods  for 
correcting  this  situation  are  installation-dependent  since  it 
involves  the  manner  in  which  files  are  created  and  initialized. 
See  section  9 of  Pait  II  for  solutions  to  this  problem  at  a 
particular  installation. 
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On  some  compute:  operating  systems  (e.g.,  MULT1CS),  it  is  not 
possible  to  prevent  two  usois  of  UFA  front  accessing  the  same 
data  s i mu  1 1 anoousl  y tot*  both  retrieval  and  update.  Ir. 

these  c.ts**:i  it  must  bo  the  responsibility  ot  the  user  to  insuiu 
that  no  other  «s«i  is  concurrently  accessing  the  smmo  data  base. 
Otherwise,  a data  base  can  become  i neonsisten t . 

No  UFA  error  messages  are  produced  when  two  or  more  users  access 
the  data  base  concurrently.  However,  if  a user  attempts  to 
physically  rewrite  a part  of  the  data  base  when  another  write 
operation  is  underway,  the  operating  system  will  abnormally 
terminate  the  command.  Section  h.3  ot  Tart  II  describes 
Multiple  Oat  a base  Usage  in  more  detail. 


These  errors  account  for  the  majority  of  the  errors  encounteted 
when  inputting  intotmation  into  the  data  base  via  INTUT-PS1  , 
These  errors  are  caused  by  improper  use  or  URL  statements 
aocordinq  to  the  lules  specified  in  the  “User  Requirements 
Lanquaqe,  Version  3.3,  lanquaqe  Reference  Manual.”*  An 
occurrence  of  any  ot  these  errors  results  in  the  statement, 
where  the  error  occurred,  being  ignored  by  the  system. 

The  ”t”  character  printed  by  UFA  is  usually  fairly  close  in 
pointing  out  where  the  ert or  occurred,  Some  of  the  more  common 
errors  (and  solutions)  are  presented  here  in  hopes  that  the 
users  will  be  able  to  apply  the  methods  of  solviny  these  errors 
t.o  their  own,  specific  needs, 

i)  Siniaa  IIIslKi* 

These  errors  are  often  encountered  through  misspellings, 
improper  format  of  the  statement  or  improper  usage  of  UKL 
reserved  words.  UFA  usually  generates  either  of  the  two  error 
me ssages: 

UKA010: REDUCE:  NO  APPLICABLE  PRODUCTION-SYNTAX  FFKOR-STAKT 
SKIPPING 

or, 

UF  AO  1 1 : ST  AC  K : ILl.LGAt  SYMBOL  PAIF-SYNTAX  ERROR-START  SKIPTINO 
For  example,  it  upon  misspelling  the  RECEIVE3  statement: 

RECEIVES  FOLDFF-  A , KOLPEF-B ; 
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MPA  will  react  by  printing  the  URAC10  orroi  message  and  skip 
that  statement  to  go  on  to  the  next.  There  are  some  further 
problems  that  can  then  occur.  If  the  error  occurred  in  a header 
statement,  such  as  PFOCESS,  then  the  header  statement  is  skipped 
and  all  statements  intended  to  he  related  to  the  header 
statement  will  be  related  to  the  previous  header  statement. 

When  a reserved  word  is  misspelled,  MPA  has  no  way  ot  knowing  if 
the  statement  was  to  be  a header  statement  or  not.  Take  the 
example : 

GROUP:  0.1; 

CSTS:  El,  F2,  02; 

PFOCCKSS:  PI; 

RCVS:  II,  I?; 

SUBPARTS:  P 2,  PI; 

ELEMENT:  FI , F 2 ; 

PhOCSSS  has  been  misspelled  which  results  in  having  that  header 
statement  skipped.  All  the  statements  following  this  header  are 
related  to  the  previous  header  which  leads  to  more  problems 
since  statements  which  can  only  be  associated  to  a PROCFSS  are 
being  attributed  to  a GROUP  name.  More  errors  will  occur  from 
this  resulting;  hence,  the  PROCESS,  RCVS  and  SUBPARTS  statements 
will  not  be  entered  into  the  data  base.  To  correct  this  error, 
the  statements  that  were  omitted  could  be  entered  by  another 
INPUT-PSL  command,  A tar  more  serious  problem  occurs  il  the 
"previous”  header  was  also  a PROCESS.  For  example; 

PROCESS  PX; 

RCVS:  11,  13; 

GFN 5 : 01,  02; 

PFOCCESS  PI ; 

RCVS  II,  12; 

SUBPAFTS  P2,  P 3 ; 

ELEMENT  El,  E2; 

It  this  wore  the  case,  then  only  one  error  would  be  caught  by 
URA  (the  misspelled  "PROCESS")  and  the  following  RCVS  and 
SUBPAFTS  statements  would  be  attributed  to  TROCESS  PX,  It  this 
mistake  were  discovered,  the  use r would  have  to  delete  the  ♦ wo 
statements  from  PX  and  then  relnput  the  information  for  Pi: 

DELFTE-PSL 

PROCESS  PX; 

RCVS  11,12; 

SUnPARTS  P 2 , P 3 ; 

EOF 

INPUT-PSL  UTDATF 

PROCESS  PI; 

RCVS  11,12; 

SUBPAFTS  P2 , P 3 ; 

EOF 
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ii)  IlliLilill  SiAlSJJill 1 

This  error  is  designated  by  the  UFA  error: 

UR A2f 8: ILLST:  ILLEGAL  STATEMENT  IN  THIS  SECTION 

This  error  can  be  caused  simply  by  using  a statement  that  is  not 
allowed  for  that  particular  section.  Using  a CONSISTS  statement 
in  a TFOCESS  section  would  obviously  generate  this  error.  The 
other  case  occurs  when  an  error  is  made  in  a header  section 
statement  and  all  the  followinq  statements  miqht  be  incompatible 
with  the  previous  header  section  name.  Whenever  this  error  is 
encountered , the  statement  is  not  put  into  the  data  base. 


i i i ) Illegal  Header  Statement 

If  an  error  occurs  in  a header  statement  and  UFA  is  able  to 
identify  it  as  a header  statement,  the  followinq  error  will  be 
qi ven: 


1 


URA025: HEAD:  INVALID  HEADEF  STATEMENT- STATEMENTS  WIL1  BE  IGNOFFP 

This  means  that  all  the  statements  up  to  the  next  header 
statement  will  be  iqnored  and  not  input  into  the  data  base.  All 
the  statements  iqnored  must,  be  reinputted  using  another 
IN  PUT- PSL  command  to  be  put  into  the  data  base. 


iv)  |nput  iini  Too  |gng 

If  a number  of  UFL  statements  are  used  on  one  line  of  the  input 
file  or  if  the  UFL  statement  is  very  long,  it  may  run  over  the 
72  column  restriction.  Should  this  occur,  usually  UFAC10  or 
UFA011  will  he  generated  specifying  that  improper  syntax  has 
been  encountered.  Note  that  no  error  message  is  generated  for 
the  fact  that  the  statement  runs  over  the  72  column  restriction. 
Errors  are  encountered  because  anything  over  column  72  is 
ignored.  Therefore,  names  may  be  truncated  or  a semicolon  lost. 


v>  IS2  lon^ 

It  is  an  easy  thing  to  mistake  a 31  or  32  character  word  for  30 
characters.  Names  longer  than  30  characters  are  cauqht  by  UFA 
and  flagged  by  the  error: 


UFA002: NLEX:  NAME  TOO  LONG 

The  statement  that  used  the  name  is  still  entered  into  the  data 
base  but  the  name  is  stored  in  a truncated  form  in  the  data 
base.  It  the  truncated  form  of  the  name  is  not  sat isf actory , it 
is  a simple  matter  to  change  the  name  via  the  FENAME  command . 


I 
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vi ) Usjgq  Reserved  Words  Incorrect 1 v 

Most  syntax  errors  ar<>  fairly  easy  to  detect;  a misspelled  word, 
improper  format,  etc.,  bat  one  of  the  hardest  to  detect  is  the 
improper  use  of  a UFL  reserved  word.  For  example,  the  followinq 
statement  would  be  flagged  by  a UFADIO  or  URAOU  error  message  as 
having  a syntax  error: 


ATTRIRUTE  TYPE  A; 

The  letter  "A"  happens  to  be  a UFL  optional  word  and  cannot  be 
used  as  a user-defined  name.  Detecting  these  reserved  words  can 
get  trickier  than  this,  howeveL,  as  the  statment: 

PROCESS  D,F,G,K; 

seems  correct,  but  "F"  is  the  abbreviation  of  the  URL  reserved 
word  "FALSE."  The  key  to  findinq  these  errors  is  to  watch  where 
the  character  is  printed  by  URA.  It  is  usually  printed 

directly  after  the  location  of  the  source  of  the  error.  The 
statement  is  iqnored  should  this  type  of  error  occur  and  the 
on  iy  solution  is  to  reinput  the  data  using  a different  name.  A 
list  of  all  URL  reserved  words  is  given  in  Appendix  B of  the 
"User  Requirements  Language,  Language  Reference  Manual."* 


vii)  Sjjnanjrm  Too 

This  error  is  specified  by  the  UFA  error: 

UR A 29  6 : SETS  YN : UNABLE  TO  MAKE  SYNONYM-TOO  COMPLICATED 

This  is  caused  by  specifying  various  relationships  about  two 
names  and  then  attempting  to  make  one  a SYNONYM  of  the  other. 
The  problem  lies  in  combining  these  relationships.  The 
statements : 


GROUP  G 1 : 

USED  BY  P 2; 

PROCESS  LONG-PROCESS-NAME; 

SUBPARTS  P 3 , P4 ; 

SYNONYM  P2; 

will  generate  the  error.  P2  is  implicitly  defined  to  be  a 
PROCESS  just  in  the  context  in  which  it  is  used  in  the  second 
statement;  it  also  has  a relationship  with  G1 . Now 
LONG-PROCESS-NAME  is  defined  and  has  relationships  formed  with 
P3  and  P4 . In  the  last  statement,  an  attempt  was  made  to  make 
P2  and  LONG-PROCESS-NAtlE  the  same  PROCESS  and  the  error  is 
generated.  The  whole  problem  could  have  been  avoided  if  the 
user  had  maintained  the  convention  of  issuing  SYNONYM  statement 


* Part  II,  URL  User's  Manual. 
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directly  after  the  header  statement  as  shown  below: 

GROUP  r.1  ; 

USED  BY  P2; 

PROCESS  LONG-PROCESS-NAME; 

SYNONYM  P2 ; 

SUBPARTS  P3;P4; 

If  the  statements  had  been  inputted  in  this  manner,  LONG- 
PROCESS-NAME  would  not  have  had  any  relationships  formed  with 
other  names  (Pi  and  P4  in  the  previous  example)  and  the 
assignment  of  P2  as  a SYNONYM  would  have  been  successful. 

Since  the  error  does  occur,  there  exists  a method  of  correcting 
this  problem: 

1)  retrieve  all  information  for  one  of  the  names  via  the  PUNCH 
parameter  for  the  FPS  command. 

2)  Delete  the  name  for  which  the  information  was  retrieved 
from  the  data  base. 

3)  Alter  the  PUNCH  information  so  that  all  the  information  now 
pertains  to  the  name  still  in  the  data  hase. 

4)  Enter  the  modified  PUNCH  information  as  input  to  the 
INPUT- PSL  command. 

In  this  way,  all  information  about  P2  is  given  to 
LONG-PROCESS-NAME  and  P2  is  assigned  as  a SYNONYM  if  future 
references  to  the  name  are  necessary.  It  is  much  easier  to 
maintain  the  convention  of  assigning  SYNONYMS  directly  after  the 
header  statement. 


viii)  Names  Used  j.n  Wroncj  Context 

This  type  of  error  accounts  for  the  majority  of  the  error 
messages  presented  in  Section  9. 

'JF  A2?2  : N LIST:  NAME  PREVIOUSLY  USED  DI F F£FF NT LY- IGNORED 

is  an  example  of  diagnostics  presented  for  this  type  of  error. 
The  statement  will  be  ignored  and  the  only  way  to  resolve  the 
problem  is  to  reinput  the  information  in  an  acceptable  format. 


ix)  Breaking  Sect  ion/St a tement  Pules 

Several  error  messages  can  be  generated  by  attempting  to  break 
the  rules  set  forth  in  the  "User  Requirements  language.  Version 


1 Part  II,  URL  User's  Manual. 
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3.3,  Language  Reference  Manual,"1 
particular  section.  In  using  the 
an  object  may  be  PART  of  only  one 
with  this  rule  will  result  in: 


for  statements  within  a 
PART  statement,  for  example, 
object  and  failure  to  comply 


URAO* 1; RWLIST:  ALREADY  PAPT  OF  SOMETHING  ELSE 

or  some  analogous  UFA  error  messaqe.  These  error  checks  are 
made  to  enforce  the  rules  set  forth  in  the  "Language  Reference 
Manual"  and  ensure  that  the  problem  statement  is  still 
meaningful.  Other  messages  presented  for  this  type  of  error 
are: 

UPA214:OTHSFS:  CONNECTIVITY  ALPFADY  GIVEN  FOP  THIS  F.FLATION 
or, 

UR AO 60: APPLES : SECOND  MAILBOX  FOP  PD  ILLEGAL 


If  t 

he  user  wishes 

to  re 

Pi 

base 

, e.g.,  replace 

the 

MA 

rela 

tionship  should 

he  d 

^1 

corr 

ect  information 

shou 

Id 

comm 

and . 

10.2 

Logica 1 Errors 

These  errors  occur  when  inputting  information  into  the  data  base 
(as  input  errors  do),  but  no  diagnostics  are  given  in  the  AS-IS 
SOURCE  LISTING.  These  errors  might  be  detected  by  scanning  the 
complete  list  of  names  in  the  data  base  (NAME-GEN)  and  the 
complete  problem  statement  (FORKAtted-PPOBLEN-STATEKENT) . These 
errors  can  also  be  detected  when  reviewing  the  contents  of  ary 
of  the  other  reports  available  on  UFA. 


Names 

A simple  spelling  error  can  result  in  two  names  which  look  very 
similar,  but  which  are  treated  as  two  different  objects  in  the 
data  base. 

For  example,  if  the  name,  "CALENDAF-DAY"  was  used  to  specify  a 
particular  INTERVAL  in  the  data  base  and  then  "CALENDAR-DAYS"  is 
used  in  the  statements. 

INTEPVAL:  CALENDAF-week ; 

CONSISTS:  7 CALENDAR-DAYS; 

the  two  names  become  completely  different  objects  (to  UPA) . UFA 
does  not  know  that  the  two  are  the  same  object  and  it  is  up  to 
the  user  to  detect  and  correct  this  mistake  which  can  be  done  in 


the  following  manner, 
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1)  Retrieve  all  information  for  one  of  the  names  via  the  PUNCH 
parameter  tor  the  FPS  command. 

2)  Delete  the  name  tor  which  the  information  was  retrieved 
from  the  data  base. 

3)  Alter  the  PUNCH  information  so  that  all  the  information  now 
pertains  to  the  name  still  in  the  data  base. 

4)  Enter  the  modified  PUNCH  information  as  input  to  the 
TNPUT-PSL  command. 

The  effect  of  doing  this  tor  the  previous  example  would  be  that: 

i)  All  information  given  about  CALENDAR-DAYS  is  transferred  to 
CALENDAR-DAY  and  then  CAPLEND AP-DAYS  is  deleted  from  the 
data  base.  If  it  is  desirable  to  use  the  plural  form  of 
the  name  in  the  data  base  then  it  should  be  a SYNONYM,  this 
can  be  done  in  a DESIGNATE  statement: 


INPUT-PSL 

DESG  CALENDAR-DAYS  SYNONYM  CALENDAR-DAY; 

EOF 

ii)  Since  names  car.  consist  of  letters  or  numbers,  and  certain 
special  characters,  another  common  misspelling  error  is  to 
substitute  the  letter  "O'*  for  the  number  "0".  It  is  often 
very  difficult  to  detect  this  and  so  there  appear  to  be  two 
names,  spelled  exactly  the  same  in  the  data  base.  This  can 
be  corrected  in  the  same  way  as  the  previous  problem. 

iii)  when  the  spelling  error  only  involves  one  name  (if 
TIME-CARD  was  spelled  TIMECAFD  in  all  instances)  then  this 
problem  could  easily  be  solved  by  using  the  RENAME  command: 

RENAME  0=TIKECAPD  N=TIM E-CAP D 

If  both  TIME-CARD  and  TIMECAFD  are  defined  in  the  data 
base,  then  the  same  procedure  used  to  change  CALENDAR-DAYS 
must  be  performed. 


Objects 


Another  error  which  occurs  quite  frequently  is  to  define  one 
object  by  two  different  names,  not  realizing  that  they  are 
representing  the  same  thinq.  EMPLOYEE- RECORD  and  EMPLOYEE-DATA 
may  be  defined  separately  in  the  data  base,  but  represent  the 
same  thing.  To  resolve  this  redundancy,  the  information  for  the 
two  names  must  be  combined.  This  can  be  done  in  the  same  manner 
as  given  for  correcting  the  misspelled  names  (involving  two 
names)  . 
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Missing  Sea jcolons 

Most  often,  a missing  semicolon  will  be  detected  as  a syntax 
error  (as  described  in  section  10.1).  There  is  one  particular 
case  where  a missing  semicolon  would  not  generate  any  error 
messaqe : 

PFOCESS  PI; 

DESCFI PTION  ; 

THIS  IS  A DESCFIPTION  COMMENT  FNTRY  THAT  IS  KISSING 
THE  SEMICOLON. 

RCVS  11,12; 

GENS  01,02; 

Hhat  happens  here  is  that  the  FCVS  statement  becomes  part  of  the 
DESCRIPTION'  comment  entry.  A semicolon  was  omitted  in 
terminating  the  lines  intended  to  be  the  comment  entry,  but  UFA 
simply  searches  for  the  first  semicolon  to  signify  the  end  of 
the  comment  entry.  To  solve  Miis  problem  the  DESCFIPTION 
statement  must  be  replaced  and  the  FCVS  statement  must  be  added 
to  the  data  base.  This  can  be  accomplished  by  the  following 
procedure . 

1)  Generate  the  incorrect  comment  entry  in  the  form  of  PUNCH 
information  (via  the  rUNCH-COKMFNT-F.NTFY  command)  . 

2)  Alter  the  PUNCH  information  so  that  the  comment  entry  is 
correct . 

3)  Use  the  modified  PUNCH  information  as  input  to  the 
REPLACE* CO MM ENT- ENTRY  Command. 

4)  Add  the  FCVS  statement  via  an  INPUT-PSL  command. 


Correctness  and  Completeness 

For  the  most  part,  it  is  up  to  the  problem  definer  to  maintain 
correctness  of  the  problem  statement  and  UFA  maintains 
correctness  of  the  data  base.  The  problem  definer  has  the 
ability  to  do  this  through  usage  of  the  DELFTE-FSL  and  INPUT-PSL 
commands.  Completeness  can  also  be  determined  bv  the  problem 
definer  or  improved  through  use  of  the  INPUT-PSL  command. 
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PAFT  II 

MSAGL  OF  THE  USEP  FFQUIBEKENTS  ANALYZES 
UNDER  KULTICS 
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1.  INTRODUCTION 


UFA  extracts  information  from  UFL  statements  and  stores  it  in  a 
UFA  data  base.  Once  this  information  (a  requirements  statement) 
is  in  the  data  base,  it  can  be  modified,  new  information  can  be 
added  to  it,  and  reports  can  be  generated  presenting  the  status 
of  the  requirements  statement.  These  actions  are  implemented  by 
the  UFA  commands  available  in  the  MPA  processing  mode.*  This 
mode  of  operation  may  be  attained  bv  accessing  the  UFA  software 
available  under  Multics.  Therefore,  by  understanding  the 
Multics  cosman  Is  that  aid  in  interacting  with  UFA,  and  the  UFA 
command  language,  the  UFA  user  can  eftectively  manipulate  the 
contents  of  a UFA  data  base. 

The  format  of  this  part  serves  an  important  purpose.  The  first 
five  sections  deal  with  Multics  and  UFA  at  an  introductory 
level.  Section  2 presents  necessary  information  tor  reference 
to  Multics  operating  svstem.  Section  3 explains  the  procedure 
of  accessing  UFA  once  on  Multics.  Sections  4 and  5 present 
practical  concepts  and  conventions  which  aid  in  using  UFA  under 
Multics.  Once  access  to  UFA  has  been  achieved.  Sections  S,  7 
and  8 present  the  manner  in  which  Multics  interacts  with  the 
various  commands.  Several  examples  are  given  in  those  sections 
in  order  to  better  illustrate  the  results  of  specific 
implementations.  Section  p deals  with  using  Multics  to  handle 
errors  encountered  in  the  use  UFA.  In  this  chapter,  the  Multics 
naming  conventions  are  used,  hence,  all  Multics  and  UF.A  commands 
appear  in  lower  case. 


* A processing  mode  is  defined  by  the  software  system  in  control 
when  any  type  of  command  is  issued.  The  debug,  facility,  the 
editor,  UFA,  etc.  all  define  processing  modes  and  thus,  a 
particular  set  of  commands. 
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2.  USING  MULTICS 


Ar.  excellent  tutorial  on  the  use  of  Multics  can  be  found  in  the 
M u 1 1 i c s User's  Guide  Honeywell  Order  Number  AL40  and  reference 
aaterial  will  be  found  in  the  Multics  Programmer's  Manuals.  The 
remaining  sections  in  this  chapter  assuae  a familiarity  with  the 
Multics  command  language. 


3.  THE  UFA  EN  VIF  ON  ME  N'T 


Assuming  that  the  user  is  already  loqged  into  Multics,  he  should 
first  gain  access  to  all  UFA  software  which  is  contained  in  the 
UFA  directory.  The  user  may  do  this  by  adding  the  UFA  directory 
to  his  search  rules  after  his  workinq  directory.  The  following 
command  shoud  be  used: 


asr  >ml>CAFA  -after  working_dir 

A UFA  data  base  with  the  name  uradb  may  be  initialized  by  the 
following  command: 

exec_co®  >ml>CAF A>initdb  uradb 

This  will  create  an  ema*-y  initialized  data  base  of  the  default 
size  in  the  current  working  directory.  To  create  a data  base 
with  a non-default  size  see  Appendix  B for  creating  data  bases. 

Once  a data  base  has  been  initialized,  the  user  may  enter  UFA 
mode  with  the  Multics  command: 

exec_com  >ml>CARA>ura 

This  command  is  used  whenever  the  user  wishes  to  enter  UFA  mode, 
whereas  a data  base  need  only  be  initialized  at  the  beginning  or 
a project.  Should  a user  desire  to  expand  or  reorganize  his 
da*a  base,  the  dump/restore  programs  described  in  Appendix  C may 
he  used. 
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4.  SPFCI FY  INO  INPUT  TO  UFA  COMMANDS 


This  section  specifies  int or ma* ion  relavant  to  using  and 
manipulating  Multics  segments  to  he  used  as  input  files  to  UFA 
commands.  The  ’’input"  and  "file"  parameters  of  UFA  commands  may 
be  used  with  standard  Multics  segments  or  int>ut  may  be  specified 
as  coming  from  the  terminal  in  an  interactive  mode. 

4.1  Entering  Da_t  a j r. » o a Data  Set 

Using  one  of  the  Multics  editors,  the  user  can  create  segments 
to  be  used  with  the  "input"  and  "file"  parameters.  Such 
segments  may  contain  names,  UFI  statements,  etc. 

If  the  user  has  URL  statements  in  the  segment  named 

mos  input. url  in  the  current  working  directory,  he  may  use  it  as 

input  for  the  ip  command  as  follows: 

ip  input  = mos.  innu*- .url  update 

4.2  Specifying  Input  Data  Interactively 

It  is  usually  advantageous  to  enter  data  into  segments  before  it 
is  used  as  input  to  UFA  as  the  user  may  correct  errors  and 
omissions  without  difficulty  using  the  Multics  editor.  There 
are  times  when  the  user  may  wish  to  enter  data  directly  to  the 
Analyzer.  In  such  cases,  the  user  specifies  "term"  instead  of 
the  segmen*-  name.  For  example,  to  provide  input  via  the 
terminal  for  the  ip  command,  use: 

ip  input=term  update 


4.3  Restrictions  on  Multiple  Data  Rase  Usage 


On  Multics,  it  is  not  possible  to  prevent  more  than  one  user 
from  accessing  the  same  data  base  concurrently.  This  is  not  a 
problem  when  such  users  are  only  retrieving  information. 

However,  it  is  a serious  problem  if  any  user  is  attempting  to 
update  the  data  base  because  this  could  make  the  tile 
inconsistent  during  the  execution  of  the  update  command.  No  URA 
error  message  is  generated  when  multiple  users  access  the  data 
base.  However,  a fortran  I/O  message  is  given  and  the  update 
command  aborted  it  a user  attempts  to  rewrite  a portion  of  the 
data  base  while  another  physical  rewrite  operation  is  underway. 
The  message  will  vary  according  to  the  version  of  Fortran  used 
and  the  location  of  URA.  A typical  message  may  be  of  the  form 


£ortran_io_:  File  already  busy  for  another  I/O  activity. 
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Unformatted  write  on  file  2. 

By  >ml>CARA>bound_db(ns$randrv  (randrw /U0) 
fortran_io_> : Close  files? 

The  user  should  respond  'yes'  and  when  UFA  asks  for  the  next 
command  the  user  should  enter 


mts  absent. 

The  user  should  then  determine  whether  the  data  base  has  been 
made  inconsistent  by  attempting  the  following: 


ng  s='all' 

set  output=temp. print 
f ps 


5.  E ECEIVING  OUTPUT  FROM  UFA  COMMANDS 


This  section  specifies  information  relevant  to  using  and 
manipulating  Multics  segments  to  be  used  as  output  for  URA 
commands.  In  Multics,  output  files  are  specified  in  the  output 
parameter  of  the  URA  set  command,  and  via  the  punch  parameter 
for  other  UFA  comands. 


5. 1 Using  the  Output  Pa rmete p 

The  output  parameter  in  the  UFA  set  command  allows  the  problem 
definer  to  specify  where  all  reports  generated  by  UFA  commands 
are  to  be  printed.  If  nothing  is  specified,  all  output  is  sent 
to  the  terminal.  To  specify  that  output  is  to  be  sent  to  a 
segment: 


set  output*segment-name 

From  this  point,  all  reports  generated  by  UFA  will  be  written 
into  this  segment.  The  report  output  may  be  reassigned  to  the 
terminal  by: 


set  output*term 


5. 2 Using  Punch  Segments 

For  some  commands,  a punch  file  is  produced.  These  are 
automatically  placed  into  segments  in  the  user's  current  working 
directory.  If  the  user  does  not  explicitly  assign  the  punch 
file,  a default  segment  name  will  be  used.  These  default 
segment  names  are  given  in  Appendix  E, 
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6.  CONTROL  COMMANDS 


These  commands  control  the  operation  of  UFA  in  some  way  without 
actually  causinq  any  output  themselves. 


6. 1 ?gt  Command 

The  most  common  use  of  this  command  is  to  change  the  default 
data  base,  or  to  reroute  the  report  output.  To  change  the  data 
base  to  be  used  on  subsequent  commands: 

set  db*data-base-segment- name 


6. 2 Display  Command 

This  command  displays  the  current  settings  of  global  switches 
and  parameters  set.  using  the  SFT  command  or  merely  defaulted  to. 

For  example,  if  the  user  wishes  to  display  the  settings  of  all 
switches  and  parameters,  he  should  type: 

display  all 

To  check  the  current  data  base  setting,  he  should  type: 

display  db 


6.3  Stop  Command 

This  command  returns  the  user  to  Multics  command  mode.  All 
parameters  changed  via  the  UFA  set  command  return  to  their 
default  values. 


11 
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7.  MODIFIER  COMMANDS 


chanqe- t y pe 
delete 

delete-comment- en  try 
delete- psl 
input-psl 

punch- comment- entry 
t ename 

teplace-comment-en t i y 


8.  REPOPT  COMMANDS 


consist-comparison 

consist  matrix 

cont  ents 

data-process 

dictionary 

dynamic-anal ysis 

entity- identifier 

ex tended- pi ct ur « 

formatted*  problem- statement 

frequency 

k v ic 

interval- consistency 

list-chanqes 

na*e-q  en 

name- list 

picture 

print- attribute- values 

process-chain 

process- input-output 

pro lee ted- cost- report 

punch- common t-en  t ry 

re source- consumption- ana  lysis 

securi ty-co ns istency-a  na lysis 

structure 

summary 
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1 1 1 


In  addition  to  tutor  comments  qon^rat«d  by  the  UFA  system,  *here 
arc  occasional  errors  associated  with  the  interaction  between 
the  UFA  system  and  F.ultics. 


q*  1 lHiilal  HiSSlUSS 

When  the  user  first  enters  UFA  mode,  he  may  receive  mossaqes 
from  flultics  that  "io-switch  does  not  exist,”  These  may  be 
ignored. 


9.2  Abji<2£idl  l£OiMlign 

If  any  of  the  commands  is  unable  tc  terminate  in  the  normal 
manner,  the  Fortran  monitor  may  bo  entered  before  UFA  has  had  a 
chance  to  close  all  files.  The  Fortran  monitor  will  ask  the 
user  if  these  files  are  to  be  closed.  In  all  cases,  the  user 
should  answer  ”yes.” 


9.3  ana  j!4 5fi  £1  L&iti  drill 

It  is  possible  for  the  user  to  qet  into  a state  where  UFA  cannot 
open  his  data  base  because  it  thinks  that  it  is  already  open. 

If  this  happens,  the  user  should  return  to  Multics  mode,  then 
issue  the  Multics  command: 

ml >C  AF  A >cl oseit 


9. 4 djjiiimiiiii  Jiariinii  mn&isjjLrs 

If  the  command  ”mts  cwd  new  working  directory”  is  qiven  any  time 
durinq  t he  Analyzer,  an  prior  condition  will  occur.  The 
Analyzer  session  will  terminate,  probably  with  the  Mutlics  erroi 
messaqo  ”Use  of  star  convention  resulted  in  no  match. 
old_workinq_directory>*  . urat  emp” , If  this  happens  t h<»  Analyzer 
exec  will  have  to  he  re-executed  in  which  evoi  workinq  directory 
the  user  would  like  to  remain. 
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1.  INTRODUCTION 


Once  a URL  description  of  an  information  processing  system  has 
been  entered  into  a UFA  data  base  the  user  has  the  option  of 
retrieving  the  stored  information  in  several  different  standard 
formats  called  UFA  reports.  Fach  UFA  report  has  particular 
characteristics  with  respect  to  its  purpose,  the  amount  of 
retrieval  and  analysis  required  to  qenerate  the  report,  the 
information  presented  in  the  report,  the  format,  etc.  In  this 
sense,  each  report  can  be  classified  by  its  characteristics  to 
provide  an  overall  description  of  the  report  and  to  aid  in 
determininq  how  the  report  may  be  used  to  aid  problem  definers 
in  checking  the  validty  of  the  UFL  description  and  to  improve  on 
its  completeness. 

Only  the  reports  generated  by  report  commands  will  be  presented 
in  this  paper.  The  reports  Generated  by  modifier  commands  are 
described  in  the  "User  requirements  Analyrer  User's  Kanual," 

Part  I.  The  manner  of  specifyinq  inout  to  report  commands  is 
qiven  in  Section  4 of  Part  I and  Section  4 of  Part  II.  The 
manner  of  receiving  output  from  report  commands  is  qiven  in 
Section  5 of  Part  I and  Section  of  Part  II. 

Section  2 of  Part  III  presents  the  objectives  of  UFA  reports 
with  respect  to  those  relationships  to  the  logical  system  design 
process  and  their  advantages  in  the  system  documentation 
procedure.  Section  3 describes  the  manner  in  which  information 
is  extracted,  from  a URA  data  base  to  produce  reports. 

Section  4 presents  several  cateuories  for  classifying  and 
describing  URA  reports  based  on  contents,  format  and  usage. 
Section  5 consists  of  descriptions  of  each  of  the  standard  UFA 
reports  available  in  Version  3.3  of  UFA. 
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2.  OBJECTS  OF  FKPOFTS  FPOK  A UFA  DATA  BASE 


2.  1 Purpose  £f  U£A  Report  s 

The  purpose  of  UFA  Reports  is  to  present  information  retrieved 
from  a UFA  data  base  (which  contains  the  description  of  a 
particular  system)  in  a format  which  is  useful  to  persons  who 
are  documenting  ♦he  target  system,  who  desire  to  understand  the 
target  system,  or  who  are  involved  in  the  design  of  the  target 
system. 

This  requires  that  the  reports  must  be  of  various  formats, 
contain  various  types  and  levels  of  information,  and  be  oriented 
at  the  various  types  of  user's. 

with  respect  to  those  persons  documenting  the  target  system,  the 
reports  must  present  information  resulting  from  modifications  to 
the  URA  data  base.  (These  reports  are  presented  in  Part  I.)  In 
addition,  reports  must  present  the  status  of  the  UFA  data  base 
after  modifications  have  been  made  (i.e.,  successful 
modifications).  Those  reports  are  basically  the  same  as  those 
used  by  people  who  desire  to  understand  the  target  system.  They 
present,  selected  portions  of  the  information  in  the  data  base  in 
various  formats.  A few  particular  reports  may  also  be  used  to 
aid  those  persons  designing  the  target  system.  They  usually 
present  the  results  of  extensive  analysis  on  information  in  the 
data  base. 


2.  2 Relation  of  JJ£A  Feports  to  logical  System  Design 
There  are  two  ma-jor  objectives  in  logical  system  design: 

- To  produce  a proposed  system  that  is  the  best  possible  in 
terms  of  what  it  will  cost  to  build,  cost  to  operate  and  what  it 
will  contribute  to  the  organization . 

- To  minimize  the  cost  and  time  to  produce  this  "optimum"  target 
system. 

The  goal  of  developing  computer-aided  methods  for  use  in  logical 
system  design  is  to  contribute  to  the  above  objectives.  At  the 
present  time,  it  is  not  possible  to  achieve  an  optimum  solution 
tor  both  of  these  objectives.  One  contribution  that  can  be  made 
by  a computer-aided  method  is  to  improve  the  "quality"  of  the 
description  of  the  target  system.  Quality  is  defined  in  terms 
of  consistency,  unambiguity  and  completeness. 

Consistency  means  that  no  statements  made  in  the  description 
contradict,  or  are  incompatible  with,  other  statements  and  any 
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particular  object  is  referred  to  bv  the  same  name  throughout  the 
description . 

Unambiguity  means  that  statements  and  i e la t ions hips  are  made  so 
precisely  that  interpretation  is  uniform  by  all  readers. 

Completeness  means  that  all  necessary  relationships  are  given 
and  no  objects  have  been  omitted  from  the  description. 

The  quality  objectives  can  be  aided  at  three  levels: 

1)  UFA  will  enforce  consistency  and  unambiguity  throuqh  the 
syntax  analysis  and  reference  checks  made  wnen  data  is 
entered  into  the  UFA  data  base. 

2)  The  UR  A reports  will  make  it  easier  for  the  problem  definer 
to  detect  loqic  errors  in  the  problem  statement,  unresolved 
conditions,  etc. 

3)  Some  reports  are  available  to  the  problem  definer  to  aid  in 
detecting  incompleteness  and  inconsistencies  of  the  problem 
statement 

Therefore,  the  first  objective  in  logical  system  design  can  be 
attained  by  improving  the  quality  of  the  documentation. 


The  second  objective,  that  of  minimizing  design  cost  and  time, 
is  aided  by  transferring  much  of  the  clerical  workload  to  the 
computer.  The  Analyzer,  UFA,  maintains  an  up-to-date  record  of 
all  informat-ion  collected.  The  preparation  of  this  information 
for  use  by  analysts,*  management,  etc.,  car.  be  readily  retrieved 
at  request. 

To  meet  these  objectives,  UFA  offers  three  classes  of  outputs: 

- Reports  to  aid  the  analyst. 

- Reports  to  aid  the  project  management. 

- Reports  to  aid  the  designer. 

- Final  specifications. 

Reports  to  aid  the  analyst  are  basically  those  which  aid  in 
resolving  inconsistencies,  ambiauities,  and  incompleteness  in 
the  logical  system  design  problem  statement. 


* NOTE:  Throughout  Part  III,  the  terms  analyst  and  problem 
definer  are  used  synonymously.  The  problem  definer  is  a person 
responsible  for  writing  a system  description  (or  part  of  one)  in 
URL.  A URA  user  is  a person  who  uses  the  URA  software  to  update 
or  retrieve  information  from  a UFA  data  base. 
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The  reports  of  concern  to  project  management  pertain  to  status 
ot  the  project  in  the  form  of  amount  of  information  entered  into 
the  UFA  data  base,  etc.  The  reports  which  are  of  benefit  to  the 
designer  are  those  which  reflect  inconsistencies  and 
incompleteness  in  the  problem  statement  which  must  be  resolved 
in  order  to  develop  a design  for  the  proposed  system.  They  also 
present  information  in  a manner  that  optimal  or  feasible  designs 
may  be  formulated. 

The  final  specifications  are  the  end  result  of  the  logical 
system  design  phase  using  URL/UFA.  They  express  all  the 
information  in  the  UFA  data  base  in  an  easy-to-read  format. 

These  specifications  consist  of  a series  of  UFA  reports 
generated  in  a particular  order  and  format. 


2.  3 Advantages  of  Usi_rg  UFA  Fejgorts 

In  contrast  to  manually  produced  documentation,  (i.e., 
handwritten  or  typed,  the  UFA  reports  have  several  advantages 
with  respect  to  maintainability,  format,  usefulness,  etc.). 


■laintainabil  jity 

Ml  changes  made  to  the  UFL  description  of  an  Information 
Processing  System  are  made  via  the  UFA  data  base.  All 
documentation  (UFA  reports)  produced  from  the  information  in  the 
data  base  after  a change  is  up-to-date.  There  is  no  need  to 
change  previous  locumen tation. 

Changes  made  to  manually  maintained  descriptions  usually  require 
modification  of  all  existing  sets  of  documentation,  and 
modification  of  each  portion  of  the  documentation  affected  by 
the  chanqe.  This  process  can  cause  serious  errors  in  the 
documentation  or  require  extensive  rewriting  (and  retyping)  of 
the  previous  documentation. 


Format 

Each  UFA  report  is  formatted  according  to  the  purpose  of  the 
report,  taking  into  consideration  the  orientation  of  persons 
intended  to  use  the  report.  Therefore,  information  consisting 
ot  many  complex  relationships  may  be  presented  in  a graphical 
format,  to  make  fhe  information  easier  to  interpret.  Likewise, 
a matrix  format  may  be  used  to  present  a large  amount  of 
information  at  one  time.  Formats  are  standardized  so  that 
interpretation  is  uniform  by  all  users. 

Formats  of  manually  produced  documentation  are  often  not 
standardized  loading  to  problems  and  conflicts  in 
interpretation.  Presentations  of  large  amounts  of  information 
on  a few  pages  is  often  a problem  because  of  difficulties  in 
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completion  and  keeping  the  information  up-to-date. 


Usefulness 

Each  UFA  repor*  has  been  designed  for  a particular  purpose, 
i.e.,  to  meet  the  system  documentation  needs  of  one  or  more 
users.  In  an  effort  to  maintain  this,  all  information  in  the 
reports  is  presented  in  a well-structured  manner  and  the  reports 
are  designed  to  be  consistent  in  their  presentations. 


Many  manually  produced  documents 
no  serious  considerations  on  how 


are  done  ad 
the  document 


benefit  the  system  building  process.  In  addi 
documentation  is  often  difficult  to  use  becau 
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Availability 
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is  produced  after  the  fact.  This  is 
ople  are  very  technically  inclined, 
e terminal  or  write  program  code 
tion.  Therefore,  when  documentation 
ble  or  the  organization  of  the 
ifficult  to  use.  Physical  production 
equires  many  hours  of  manual  labor 
ers  excluding  the  time  and  costs  of 
(It  is  important  to  note  that  in  most 
n produced  in  this  way  is  usually 
leaves  the  typewriters.) 


UFA  reports  may  be  generated  containing  all  ♦•he  information 
known  about  the  target  system  as  containing  specific  information 
about  one  particular  name  relevant  to  the  description.  This 
capability  allows  the  user  to  see  only  what  is  desired  rather 
than  getting  too  much  or  too  little. 

It  would  be  virtually  impossible  to  incorporate  all  possible 
combinations  of  information  in  a manually  produced  system  in  an 
effort  to  anticipate  any  type  of  reauest.  Therefore,  the 
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a 


description  of  the  tarqot  system  is  presented  in  a select  number 
of  ways  an  t any  information  not  directly  available  must  he 
desired  from  the  available  information  (assuming  it  is  in  soie 
way  desirable) . 


iUillsis 

UFA  offers  reports  which  aid  in  checking  completeness  and 
consistency  of  the  problem  statement  as  it  exists  in  the  UFA 
data  base.  P.anv  of  the  reports  present  information  in  a manner 
which  allows  v i sua 1- ana  1 y si s of  the  information  to  check  for 
these  qualities.  Other  reports  incorporate  these  checks  as  part 
of  the  information  presented  in  the  report  and  is  referred  to  as 
computer-aided  analysis.  (Visual  analysis  implies  that  the 
checks  are  made  by  the  user  where  computer-aided  analysis  is 
performed  by  the  computer.) 

In  most  forms  ot  manually  produced  documentation  the  formats 
used  make  it  difficult  to  check  for  completeness  and 
inconsistencies  in  the  documentation.  Inconsistencies,  in 
particular,  qo  undetected  very  easily  as  a result  of  various 
spellinqs  of  the  same  name  in  the  description.  Where  one  person 
may  know  that  all  the  versions  of  the  name  refer  to  the  same 
thinq,  others  may  not. 
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Extensions 

In  addition  *o  the  standard  reports  available  in  a particular 
version  of  UFA , the  users  mav  write  their  own  proqrams  which 
qenerate  reports  to  present  information  particular  to  their 
applications  of  UFA.  The  new  reports  can  be  incorporated  into 
any  future  documentat ion  nackaqes. 

Manually  produced  documentation  may  incorporate  complex  reports 
involvinq  a qreat  amount  ot  computation  and  analysis  in  its 
production,  but  this  requires  the  same  amount  of  computation  and 
analysis  anytime  the  report  is  to  be  presented.  Rather  than 
consuming  the  analyst’s  time  in  producing  the  report,  it  is  more 
feasible  to  let  the  computer  do  it  (and  in  less  time). 
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3.  GENERATION  OF  REPORTS 


All  UPA  reports  are  produced  by  issuing  commands  to  UFA.  All 
commands  available  for  UFA  and  the  reports  generated  by  each  are 
given  in  "User  Requirement  Analyzer  Command  Descriptions." 
Descriptions  of  each  report  and  the  name(s)  of  the  command(s) 
used  to  generate  it  are  qiven  in  Section  5 of  Part  III. 


3. 1 UBA  Command  Language  for  Reports 

The  programs  which  are  initiated  by  a particular  report  command, 
retrieve  information  from  the  URA  data  base  and  output  it  in 
some  meaningful  format.  No  modifications  are  made  to  the 
information  in  the  data  base;  their  sole  function  is  to  retrieve 
the  information  and  display  it  in  some  manner.  In  the  process 
of  collecting  and  displaying  the  information  analysis  may  be 
done  and  the  results  printed  as  part  of  the  report. 

Most  report  commands  have  one  or  more  parameters  that  may  be 
used  in  con-junction  with  the  command  for  one  of  the  following 
pu  rposes: 

- To  specify  data  to  be  used  as  input  to  the  command  (Input  data 
parameters) . 

- To  specify  how  data  used  as  input  is  to  be  interpreted  (Input 
control  parameters) . 


- To  specify  what  options  the  user  has  in  generating  the  report 
with  respect  to  content  (Output  option  parameters) . 


- To  specify  what  options  the  user  has  in  generating  the  report 
with  respect  to  format  (Output  format  parameters)  . 

The  manner  of  specifying  commands  and  their  parameters  is  given 
in  Part  IV  and  the  manner  of  using  the  commands  and  parameters 
is  given  in  Parts  I and  II. 


3. 3 Fetr^eva 1 of  Information  fr^n  Ihe  UFA  Data  Rase 

There  are  basically  three  types  of  information  stored  in  a UFA 
data  base. 


1)  Names  and  types  of  objects  defined  by  the  user. 

2)  Comment  entries  (narrative  and  free  format  descriptions  of 
objects)  . 


3)  Connections  among  objects  and  between  an  object  and  comment 
entry. 
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The  first  typo  of  information  is  stored  as  name  records,  the 
second  as  comment  entty  records,  and  the  last  as  NUB  records.* 

Each  UFA  report  presents  information  taken  from  one  or  more  of 
these  different  types  of  records.  Table  2 gives  the  information 
presented  by  each  report.  In  addition  each  UFA  report  may  also 
present  information  derived  from  the  information  in  one  or  more 
of  these  different  types  of  records. 

The  manner  in  which  the  information  is  presented  differs  from 
one  report  to  another.  The  relationship  between  two  name 
records  may  be  eithet  implied  by  the  report  format  or  explicitly 
defined.  For  example,  the  FORMATTED  PI  OBLEK  STATEMENT  would 
present  that  ’’employee-address"  CONSISTS  of  "street,"  "city," 
"state,"  and  "zip-code."  The  CONTENTS  REPORT,  on  the  other  hand 
would  present  this  in  the  followina  format: 

1 omnl oyee-address 
2 street 
2 city 
2 state 
2 zip-code 


Therefore,  there  are  three  major  aspects  relative  to  what  is 
contained  in  a UFA  report: 

1)  What  typo  of  information  is  presented: 

a)  Names  and  types  of  oblect 

b)  Comment  *ntncs 

c)  Connections  among  objects  and  between  an  object  and 

comment  entry 

2)  How  the  information  is  presented: 

a)  As  taken  from  the  UFA  data  base 
h)  Derived  from  information  in  the  data  base 

3)  How  Relationships  are  defined: 

a)  explicitly 

b)  implied 


1 See  the  description  ot  these  records  as  presented  in  Section  7 
of  Part  I tor  a better  understanding  of  the  data  base  structute. 
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Report  Name 

Name 

F eco  rds 

Comment 

Entries 

NUB 

Records 

Update 

Records 

ATTRIBUTE  FEPOFT 

Yes 

No 

Yes 

No 

CONSISTS  COMPARISON'  MATFIX 

Yes 

No 

Yes 

No 

CONSISTS  MATFIX  REPORT 

Yes 

No 

Yes 

No 

CONTENTS  FEPOFT 

Yes 

No 

Yes 

No 

DATA  BASE  SUMMARY* 

No 

No 

No 

No 

DATA  PROCESS  FEPOFT 

Yes 

No 

Yes 

No 

DICTIONARY  REPORT 

Yes 

Yes 

Yes 

No 

DYNAMIC  ANLAYSIS  REPORT 

Yes 

No 

Yes 

No 

EXTENDED  PICTURE 

Yes 

No 

Yes 

No 

FORMATTED  PROBLEM  STATEMENT 

Yes 

Yes 

Yes 

Y es 

FREQUENCY  REPORT 

Yes 

No 

Yes 

No 

IDENTIFIER  INFORMATION 

REPORT 

Yes 

No 

Yes 

No 

INTERVAL  CONSISTENCY  FEPOFT 

Yes 

No 

Yes 

No 

KWIC  INDEX 

Yes 

No 

No 

No 

LIST  CHANGES 

No 

No 

No 

Y es 

NAME  GEN 

Yes 

No 

No 

Yes 

NAME  LIST 

Yes 

No 

No 

Yes 

PICTURE 

Yes 

No 

Yes 

No 

PROCESS  CHAIN 

Yes 

No 

Yes 

No 

PROCESS  INPUT/OUTPUT 

Yes 

Yes 

Yes 

No 

PROJECTED  COST  FEPOFT 

Yes 

No 

Yes 

No 

PUNCHFD  COMMENT  ENTFISS 

Yes 

Yes 

Yes 

No 

RESOURCE  CONSUMPTION 

ANALYSIS 

Yes 

No 

Yes 

NO 

SEC  UR Im  Y CONSISTENCY 

ANALYSIS 

Yes 

No 

Yes 

NO 

STRUCTURE 

Yes 

No 

Yes 

No 

Table  2. 


Types  of  Information  Taken  and  Presented  by  UFA  Reports 


1 All  information  in  this  report  is  "derived"  from  the 
information  taken  from  each  of  the  different  types  of  records. 
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ATTRIBUTE  REPORT 


mBgse 


This  report  is  intended  to  present  the  system  properties  aspect 
of  the  target  system  description  with  respect  to  the  ATTRIBUTES 
defined  and  used  in  the  description. 


fl 

fl 


luigjaaiiaii 

The  report  presents,  for  each  ATTRIBUTE  name  used  as  input,  all 
names  m the  data  base  to  which  the  ATTRIBUTE  applies  and  the 
associated  ATTRIBUTE- VALUES  for  the  names.  In  effect,  this 
presents  information  given  by  the  ATTRIBUTE  statement. 


Zonal 

Each  ATTRIBUTE  name  is  numbered.  1*,  2*,  etc,,  as  it  is 
encountered  as  input  and  'printed  on  the  report.  Each  name  to 
which  a particular  ATTRIBUTE  applies  is  also  numbered. 

The  URA  statements: 

INPUT:  time-card: 

ATTRIBUTE  arrival-type  scheduled; 

would  be  presented  as: 

1*  ATTRIBUTE:  arrival-type 

i 

APPLIES  TO:  VALUE: 

1 time-card  scheduled 

in  the  ATTRIBUTE  REPORT  for  the  ATTRIBUTE  arrival- type.  Given  a 
particular  ATTRIBUTE  name,  the  software  generating  the  report 
searches  the  data  base  for  all  names  the  ATTRIBUTE  APPLIES  to 
(is  connected  to)  and  lists  them  under  the  "APPLIES  TO:"  heading 
in  the  report  with  corresponding  ATTRIBUTE- VALUE  under  the 
"VALUE:"  heading. 

- 

The  format  for  the  ATTRIBUTE  REPORT  is  considered  to  be  a list 
format. 


2£li2£  an<!  lliflMiives 

The  report  may  be  generated  for  a single  ATTRIBUTE  name  (vi$  the 
NAME  parameter)  or  for  a collection  of  ATTRIBUTE  names  specified 
by  the  user  or  retrieved  via  NAME-GEN. 
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MAlJL§l§ 

Each  name  given  as  input  in  gcnerat  in*}  the  report  aunt  ho 
checked  that  it  is  an  ATTRIBUTE  name  ht  fore  further  processing 
continues.  The  nano  is  then  printed  on  the  report.  If  the 
input,  name  is  not  an  A7TFIHUTF  the  message: 

UFAC93:  KATNPAV:  NAME  HAS  NO  USAGES  AS  ATTRI  BU^E  FOF  ANYTHING 

is  printed.  Names  and  corresponding  ATTRI 0 UTE- VALUES  are  then 
retrieved  pair  hy  pair  and  listed  undei  the  given  ATT°I DUTF 
until  no  more  pairs  are  found  for  th°  ATTRIBUTE. 

The  next  ATTFIBUTE  name  from  the  input  stream  is  taken  (it  there 
is  one)  and  the  process  repeats. 


ilsaass 

In  many  applications  of  the  use  of  the  Language  and  Analyzer, 
certain  ATTRIBUTE  names  may  be  designated  as  mandatory  for  a 
lescription.  For  example,  some  applications  may  require  that 
every  PROCESS  defined  as  part  of  the  description  must  be 
specified  as  being  either  manual  or  automated  via  the  ATTRIBUTE 
process-t vpe.  Generation  of  the  ATTRIBUTE  RE  TOFT  for  the  name 
process-type  allows  the  analyst  to  determine  if  the  current 
description  is  accurate,  complete  and  consistent  in  this 
respect . 

The  report  also  presents  those  names  which  are  logically  related 
because  of  common  ATTR I D UTF- VA LUFS  among  them.  In  the  previous 
example,  there  were  two  logical  groups,  manual  and  automated. 

In  practice  there  are  usually  several  possible  ATTFI BUTE- VALUES. 


•5MBJ2I2.S 

Figure  19  presents  the  output  resulting  from  generating  the 
ATTRIBUTE  rEPORT  using  the  names  produced  by  NAME-GKN  as  input. 
The  following  Analyzer  commands  were  given: 

NAME-GEN  S - ' AT7RI BUTE’ 

PRINT- AT  TRIP UTF- VALUES 
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Purpose 

To  present  data  structure  information  for  SET,  INPUT,  OUTPUT, 
ENTITY  and  GFOUP  names  qiven  as  input.  The  report  by-passes  all 
intermediate  levels  of  data  structure  and  only  presents  the 
lowest  level  constituents  of  those  names  qiven  as  input. 


Information  Presented 

Structure  information  based  on  CONSISTS  statements  in  the  data 
base  can  be  presented  for  SET,  INPU^,  FNTITY  and  GROUP  names 
qiven  as  input.  However,  rather  than  presenting  all  levels  of 
the  data  structure,  only  the  hiqhesf  and  lowest  levels  are 
present  iqnorinq  all  other  levels.  *01  example,  the  structure: 

1 hourly-employee-record 
2 employee-name 
3 surname 
3 initial 
3 first-name 

2 employee- identification- number 
2 socia 1-security- number 

raiqht  appear  in  the  CONTENTS  F5PPFT  which  presents  all  levels  of 
the  data  structure  for  hourly-empl oyee- record . The  CONSISTS 
COMPARISON  REPORT,  however,  would  present  the  names: 

surname 
initial 
first- name 

em  pi oyee- identification- number 
social- security- number 


as  the  low  level  components  of  the  data  structure  for 
hourly-employee-record . 

In  addition  to  the  data  structure  relationships  presented, 
similarities  among  data  structures  are  identified  and  summarized 
in  the  report. 
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level  constituents  an  1 each  column  of  the  matrix  represents  one 
of  the  names  given  in  the  list  of  input  names.  All  names  in  the 
list  and  tows  and  columns  are  numbered  so  that  the 
correspondence  hetween  a particular  row  or  column  and  the  name 
that  it  represents  is  one  to  one.  A relationship  between  a name 
represented  by  <t  particular  row  and  a name  represented  by  a 
narticular  column  is  designated  hy  an  asterisk  entry  (*)  at  the 
intersection  or  the  row  and  column  in  the  matrix.  A blank  entry 
designates  that  no  such  relationship  exists. 

A second  matrix  called  the  CONTENTS  SIMILARITY  MATRIX  is  also 
generated  to  present  similarities  in  the  data  structures  (for 
those  names  given  as  input)  and  represented  in  the  BASIC 
CONTENTS  MATFIX.  All  information  in  the  CONTENTS  SIMILAT ITY 
MATRIX  is  derived  from  information  presented  in  the  BASIC 
CONTENTS  MATFIX.  All  the  names  used  as  input  are  represented  by 
a column  number  and  tow  number  in  the  matrix.  The  numbers  are 
the  same  so  that  any  qiven  obiect  is  represented  by  row  I and 
column  J.  The  matrix  should  be  read  riom  row  to  column  as 
sayinq:  the  data  obiect  represented  by  row  I has  an  integer 
number  of  low  level  constituents  in  common  with  the  data  obiect 
represented  in  column  J.  when  J=J,  the  number  of  low  level 
constituents  of  any  obiect  in  common  with  itself  is  presented. 
This  is,  of  course,  th  3 total  number  of  constituents  for  that 
given  data  obiect,  Tho  final  section  of  this  report  is  the 
CONTENTS  SIMILARITY  ANALYSIS  which  presents  those  input  names 
that  have  identical  lowest  level  constituents  or  which  are 
strict  subsets  (at  the  lowest  level)  of  other  input  names. 


2i>ii2iLs  2nd  ilininnii  vnn 


No  options  are  available  to  change  format  or  content  of  the 
report , 

malms 

Each  name  given  as  input  is  searched  for  in  the  Analyzer  data 
base.  If  the  name  is  not  round,  the  message; 

UFA271:  MAINCNC:  NAME  NOT  IN  P.B.- 
is  printed  ar.d  is  net  represented  ir.  the  matrices. 


For  each  name  defined  in  the  data  base  with  CONSISTS 
information,  its  components  are  then  round  via  the  CONSISTS 
statement.  If  its  components  have  CONSISTS  information  then  the 
procedure  is  continued  until  only  ELEMENTS  are  encountered 
(which  may  not  have  any  sub-components)  or  no  more  CONSISTS 
information  can  be  round.  The  lists  of  input  names  and  low 
level  constituents  are  then  printed  or  the  report. 

The  BASIC  CONTENTS  MATRIX  is  then  printed  out  to  illustrate  the 


* 
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relationships  between  the  names  in  the  two  lists  and  each 
relationship  is  designated  by  an  asterisk. 

The  CONTENT?  SIMILARITY  MATRIX  is  produced  by  counting  the 
number  of  column  entries  in  common  between  any  two  rows  of  the 
BASIC  CONTENDS  MATRIX.  "’he  diaqonal  is  produced  by  counting  the 
total  number  of  asterisks  in  the  RASIC  CONTENTS  MATRIX  for  a 
given  row. 

The  CONTENTS  SI  MILA  EITY  SUMMAFY  is  produced  by  inspecting  the 
numerical  values  in  the  CONTENTS  SIMILARITY  MATRIX.  If  a 
particular  number  presented  in  the  diagonal  occurs  elsewhere  in 
the  same  row  of  the  matrix,  it  means  that  a particular  name 
(represented  by  the  row)  has  all  of  its  constituents,  in  common 
with  another  name.  If  the  other  name  has  the  same  number  of 
constituents,  then  the  data  structures  are  identical.  If  the 
other  name  has  more  constituents,  then  the  first  name  has  a data 
structure  which  is  a subset  of  the  others. 


Jlssag 

One  use  of  the  CONSIST?  COMPARISON  FILOFT  is  to  detect  redundant 
or  similar  data  structures.  Its  ability  to  do  this  lies  in  its 
presentation  (ignoring  all  intermediate  levels  of  data 
structure) . 

This  aids  the  analyst  in  detecting  possible  errors  in  the  target 
system  description  and  simplifying  it  should  similarities  in 
structures  occur.  This  is  usually  beneficial  when  the  report  is 
generated  for  all  INPUT,  OUTPUT  ar.d  ENTITY  names  in  the 
description  as  input. 

The  report  is  also  beneficial  to  the  system  designer  who  may 
utilize  it  to  optimize  structures  that  the  software  will 
eventually  have  to  access.  Identical  or  similar  structures  for 
different  ENTITIES,  for  example,  may  be  mapped  into  the  same 
type  of  storage  structure  to  reduce  complexity  of  the  software. 


Ex^i^les 

Figure  20  presents  the  results  of  generating  the  CONSISTS 
COMPARISON  PEPOFT  for  all  INPUT  and  OUTPUT  names  in  a particular 
data  base.  The  following  commands  were  used  to  generate  the 
example: 

NAME-GEN  S='INFUT  OP  OUTPUT' 

CONSISTS- COM PARI  SON 

Note  that  the  two  names  name-six,  name-two,  and  paysystem-inputs 
are  not  included  in  the  matrices  because  they  do  not  have 
CONSISTS  information. 
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To  present  the  data  structure  (as  specified  by  the  CONSISTS 
statements) , either  above  or  below,  each  SET,  INPUT,  OUTPUT, 
ENTITY,  GROUP  and/or  ELEMENT  name  given  as  input  is  involved  in. 


Information  Presented 


Each  name  given  as  input  must  he  a SEI,  INPUT,  OUTPUT,  ENTITY, 
GFGHF  or  ELEMENT  name.  The  report  presents  tne  names  that  the 
given  input  name(s)  CONSISTS  of  (if  the  report  is  generated  with 
the  CONSISTS  parameter  in  effect)  or  names  the  given  input 
name (s)  is(are)  CONTAINED  in  (if  the  report  is  generated  with 
the  CONTAINED  parameter  in  effect) . Take  the  following 
structure,  for  example,  and  assume  that  its  description  exists 
in  an  Analyzer  data  base  in  the  form  of  CONSISTS  relationships 
between  the  names: 


(SET)  -- 
(ENTITIES)  -- 


(GFOUPS)  — 


(ELEMENTS)  — 


ENT- A 


EL-A 


SET- A 

level 

I \ 

ENT-B  ENT-C^ 

level 

GF-C  GR-D 

1 / 1 

\ 

GP-E 

level 

' ' I 

EL-B  EL-C 

level 

If  the  CONSISTS  MATRIX  PEPOFT  were  generated  for  all  the  above 
GF.OUP  names,  GP-A,  GR-3,  GF-C,  GF-D  and  GR-E,  and  the  CONSISTS 
parameter  was  in  effect  when  generating  the  report,  the  ELEMENT 
names  EL-A,  EL-B  and  EL-C  would  be  presented  in  the  report.  The 
report  would  also  designate  GR-A  and  GR-E  as  not  having  any 
CONSISTS  information  available. 

If  the  report  was  generating  with  the  CONTAINED  parameter  in 
effect,  and  the  same  GROUP  names  as  input,  the  ENTITY  names 
fiNT-A,  ENT-B  and  SNT-C  would  be  presented  in  the  report 

In  essence,  the  CONSISTS  MATPIX  FEPOKT  presents  one  level  above 
or  one  level  below  designated  starting  points  in  the  data 
structures  described  in  an  Analyzer  data  base. 

The  report  could  not  be  generated  for  SET  names  with  the 
CONTAINED  parameter  in  effect  because  the  Language  does  not 
allow  SETS  to  be  CONTAINED  in  higher  level  structures. 
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Likewise,  the  report  could  not  be  generated  for  ELEMENT  names 
with  the  CONSISTS  parameter  in  effect,  because  the  Lanquaqe  does 
not  allow  ELEMENTS  to  CONSIST  of  lower  level  structures. 

The  report  also  presents  statistics  on  the  data  structure 
information  such  as  how  many  low  level  components  a particular 
name  consists  of  or  how  many  structures  it  is  contained  in. 


Format 

If  the  CONSISTS  parameter  is  used  when  qeneratinq  the  report, 
any  names  qiven  as  input,  which  do  not  have  CONSISTS  statements 
as  part  of  ♦heir  descriptions  are  flaqqed  at  the  beqinninq  of 
the  report.  If  the  CONTAINED  parameter  is  used,  any  names  qiven 
as  input  which  do  not  have  CONTAINED  statements  as  part  of  their 
descriptions  are  flaqqed. 

Two  lists  of  names  are  then  presented,  one  labeled  ROW  NAMES  and 
the  other  COLUMN  NAMES.  If  the  CONSISTS  parameter  was  used  when 
qeneratinq  the  report,  the  names  designated  as  COLUMN  NAMLS  are 
those  which  were  qiven  as  input.  If  the  CO NTAINED  parameter  was 
used  when  qeneratinq  the  report,  ♦he  names  desiqnated  as  ROW 
NAMES  are  those  which  were  qiven  as  input. 

In  any  case,  each  name  under  COLUMNS  NAMES  CONSISTS  of  zero  or 
more  names  under  POW  NAMES  and  each  name  under  ROW  NAMES  IS 
CONTAINED  in  zero  or  more  names  under  COLUMN  NAMES.  A matrix  is 
then  printed  to  show  the  relationships  between  the  names 
desiqnated  as  FOW  NAMES  (which  are  represented  by  the  rows  of 
the  matrix)  and  the  names  desiqnated  as  COLUMN  NAMES  (which  are 
represented  by  the  columns  of  the  matrix).  The  rows  and  columns 
of  the  matrix  are  numbered  to  correspond  to  the  number  assiqned 
to  each  name  in  the  list  of  POW  NAMES  and  COLUMN  NAMES, 
respecti vel y. 

An  astarisk  (*)  entrv  at  the  intersection  of  a particular  row 
and  column  of  the  matrix  desiqnates  that  the  name  represented  by 
the  row  is  CONTAINED  in  the  name  represented  by  the  column. 

Inspection  of  an  entire  row  reveals  all  names  that  a particular 
name  (represented  by  the  row)  is  CONTAINED  in.  Inspection  of  an 
entire  column  reveals  all  names  that  a particular  name 
(represented  by  the  column)  CONSISTS  of. 

A summary  section  is  also  included  in  the  report  presenting  for 
each  POW  NAME: 

- The  row  it  was  represented  by  in  the  matrix  (POW). 

- Its  name  type  (TYFF) . 

- The  number  of  * entries  in  its  row  (or  the  number  of  names 
CONTAINING  it)  (COUNT) . 
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The  summary  presents  fot  each  COLUMN  NAME: 

- The  column  it.  was  represented  by  (COLUMN). 

- Its  name  type  (TYPF)  . 

- The  number  ot  * entries  in  its  column  (or  the  number  ot  names 
it  CONSISTS  of)  (COUNT). 

The  summary  section  for  ROW  and  COLUMN  names  is  ordered  in 
decreasing  order  of  COUN". 


gpt Apns  and  Al t wrpat \ yes 

The  report  must  be  generated  using  either  the  CONSISTS  or 
CONTAINED  parameter.  If  the  CONSISTS  parameter  is  used,  all 
names  given  as  input  must  be  SET,  INPUT,  OUTPUT,  ENTITY  and/or 
GPOUP  names.  If  the  CONTAINED  parameter  is  used,  all  names 
given  as  input  must  be  INPUT,  OUTPUT,  ENTITY,  GROUP  and/or 
ELfMENT  names. 

The  report  may  be  generated  tor  a single  input  name  (via  the 
NAME  parameter)  or  tor  a collection  of  input  names  either 
specified  by  the  user  or  retrieved  via  NAME-GEN. 


is 

Each  name  given  as  input  is  searched  tor  in  the  data  base.  If 
it  is  no*  found,  the  message: 

UFAC98:  CCNCOI.:  NAME  NOT  IN  D.B.- 


is  printed. 

It  the  CONSISTS  parameter  is  used,  each  name  given  as  input  must 
be  checked  that  CONSISTS  information  is  available  for  it.  If  no 
CONSISTS  information  is  available,  the  name  is  listed  under  the 
message: 

UPA  31 3:  CONCOL  : THE  FOLLOWING  DO  NOT  CONSIST  OF  ANYTHING: 

The  components  of  those  input  names  which  do  have  CONSISTS 
information  are  found.  The  list  of  all  input  names  and  the  list 
of  all  components  are  then  printed  on  the  repor*. 

If  the  CONTAINFD  parameter  is  used,  each  name  given  as  input 
must  be  checked  that  CONTAINED  information  is  available  for  it. 
If  no  CONTAINED  information  is  available,  the  name  is  listed 
under  the  message: 

HP  A31 1 : CONFOW  : THE  FOLLOWING  AFF  NOT  CONTAINFD  IN  ANYTHING: 
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Those  names  which  the  input  names  are  CONTAINED  in  are  found. 
The  list  of  all  input  names  and  the  list  of  names  they  are 
CONTAINED  in  aie  ther.  printed  on  the  report. 

A matrix  is  printed  out  to  illustrate  the  relationships  between 
the  names  in  the  two  lists  and  each  relationship  is  designated 
by  an  asterisk. 

A summary  is  then  produced  by  counting  the  number  of  asterisks 
appearing  in  each  row  and  each  column  of  the  matrix. 


Usages 

When  a lis*-  of  FLEKLNT  and/or  GROUP  names  are  given  as  input  to 
the  command  producing  the  report  and  the  CONTAINED  parameter  is 
specified,  the  report  aids  the  analvst  by  identifying  which 
CROUP  and  ELEMENT  names  are  not  incorporated  into  higher  level 
information  structures.  It  aids  the  physical  system  designer  by 
determining  utilization  of  ELEMENT  and  GFOUP  names  by  the 
logical  information  structures  within  the  target  system 
description . 

Generating  the  report  (using  the  CONSIST?  parameter)  for  SFT , 
INPUT,  OUTPUT,  ENTITY  and  GROUT  names  determines  which  of  these 
have  identical  structures,  with  respect  to  one  another,  and 
which  are  emptv,  i.e.,  have  no  CONSISTS  relationships.  This 
also  identifies  similarities  in  the  structures  for  these  types 
of  names.  The  analyst  may  then  tis»  this  information  to 
determine  if  redundant  structures  have  been  lefined,  if  the 
description  is  incomplete,  etc. 


UMe 

Figure  21  presents  the  CONSISTS  MATFTX  REPORT  generated  with  the 
CONSISTS  parameter  in  effect  and  using  all  INPUT  and  OUTPUT 
names  in  a particular  data  base  as  input. 

Figure  22  presents  the  report  generated  with  the  CONTAINED 
parameter  in  ; effect  and  usinq  all  GROUP  names  in  a particular 
data  base  as  input.  The  Analyzer  commands  used  to  generate  this 
example  were: 


NAME-GEN  S='GFOUP' 
CONSISTS-* ATRIX  CONTAINED 
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CONTENTS  FFPOF^ 


Purpose 

To  allow  the  user  *-o  view  entire  data  structures  (all  levels)  - 

described  in  the  Analyzer  data  base  as  implied  by  the  use  of  the 
CONSISTS  statemon*. 


Information  Presented 

The  CONTENTS  RLPOFT  presents  all  lower  levels  of  data  structures 
for  SET,  INPUT,  OUTPUT , ENTITY  and  GPOUP  names  used  as  input. 
(Since  ELEMENTS  mav  not  have  CONSISTS  information  they  cannot  be 
used  as  inpu'-  to  produce  the  report.)  All  names  which  the  input 
names  CONSIST  of  are  designated  as  level  2 names;  the  names  that 
the  level  2 names  CONSIST  of  are  designated  as  level  3 names, 
etc. 

The  CONSISTS  statement  allows  network  structures  to  be 
constructed  and  so  any  jiven  name  may  be  CONTAINED  ir  more  than 
one  structure,  and  at  different  levels  in  the  different 
structures.  The  types  of  names  presented  in  the  structures  will 
be  INPUTS,  OUTPUTS,  ENTITIES,  GFOMPS  and  ELEMENTS. 


Format 

Each  name  qiven  as  input  to  the  report  is  identified  by  a nunber 
1*,  2*,  etc.,  designating  its  position  in  the  list  of  input 
names  and  also  by  the  number  1 designatinq  it  as  a level  1 name. 
All  names  that  are  part  of  its  structure  are  numbered  1 though  n 
according  to  its  position  in  the  structure  when  printed  out  and 
also  numbered  according  to  the  name's  relative  level  in  the 
structure,  ^ach  level  2,  3 and  sc  on  is  indented  to  further 
accent  the  idea  of  structure.  A SYSTEM- PA F AM  ETEF  or  a numerical 
value  may  be  used  with  the  CONSISTS  statement.  In  this  case  the 
VALUE  of  the  SYSTEM-PA HAMETEE  or  the  numerical  value  will  be 
printed  after  the  contained  name.  Fach  group  of  names  of  a 
qiven  level  number  ar°  CONTAINED  in  the  preceeding  name  of  the 
next  highest  level  number.  (Level  1 is  the  highest  level 
number.)  For  example,  the  following  URL  description: 

ENTITY  hourly-emplovee  record; 

CONSISTS  employee-name, 

employee- identification- number, 
social -security- number; 

GFOUP  employee-name; 

CONSISTS  surname, 
initial, 
f irst- name; 
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would  appear  as: 

1*  1 hourly-employee-record 

1 2 employee- name 

2 3 surname 

3 3 initial 

4 3 first-name 

• 5 2 em ployee- iden ti f ica t ion-number 

6 2 social-security-number 

in  the  CONTENTS  PEPOFT  if  the  report  was  generated  for 
hourly-employee-record.  If  the  report  was  generated  for 
employee-name  the  following  structure  would  appear: 

1*  1 employee-name 

1 2 surname 

2 2 initial 

3 2 first-name 


Options  and  Alternatives 

The  user  may  restrict  the  number  of  levels  of  the  data 
structures  presented  when  a numerical  value  is  assigned  to  the 
LEVELS  parameter.  For  example,  when  LEVELS=2  is  given  only  the 
names  at  levels  one  and  two  of  the  data  structure  are  presented 
in  the  report.  The  report  normally  prints  out  ALL  levels  of  the 
data  structures. 

GROUPS  in  the  structures  which  do  not  CONSIST  of  lower  level 
information  or  those  UNDFFINFD  names  in  the  structure  are 
flagged  bv  the  message: 

**N0  CONSISTS  FOF  GROUP  OF  UNDEF** 

when  the  NCFLAG  parameter  is  used.  An  index  for  the  report  is 
produced  when  the  INDEX  parameter  is  used. 

Security  information  concerning  the  names  printed,  as  specified 
by  the  CLASSIFICATION  statement,  can  be  printed  on  the  report 
when  the  PRINT-SSCUFI'T'Y-INFOFMATICN  parameter  is  used. 

The  report  may  be  generated  for  a single  input  name  (via  the 
NAME  parameter)  or  for  a collection  of  input  names  either 
specified  by  the  user  or  retrieved  via  NAME-GEN. 


Analysis 

Each  name  given  as  input  is  searched  tor  in  the  data  base.  If 
the  name  is  not  found,  the  message: 


UF  A J 65: 


MAINCONT: 


NAME  NO 1 FOUND  IN  D.B.- 
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For  each  name  given  as  an  input,  each  name  which  is  CONSISTS  of 
is  designated  as  a leval  2 name  as  it.  is  printed  out.  If  this 
level  2 name  CONSISTS  of  any  information,  then  each  name  which 
it  CONSISTS  of  is  designated  as  a level  3 name  as  it  is  printed 
out.  This  process  continues  until  no  more  CONSISTS 
relationships  are  found  or  the  level  specified  by  the  LEVELS 
parameter  is  reached. 


i 


t 


Names  are  printed  out  as  they  are  encountered  in  the  structure. 


Usage 

For  the  analyst,  the  report,  presents  information  structures  as 
defined  by  the  use  of  the  CONSISTS  statement  in  a format  in 
which  the  entire  structure  can  be  seen.  It  is  usually  most 
beneficial  to  generate  the  CONTENTS  EE PORT  for  INPUT,  OUTPUT  and 
ENTITY  names  in  t.he  data  base  since  all  major  information 
constructs  are  based  around  these  tyDes  of  names. 

Completeness  checks  on  the  structure  information  in  the  data 
base  can  be  performed  by  specifying  the  NCFLAG  parameter  when 
generating  the  report.  Since  all  GROUPS  should  consist  of  other 
information  (by  definition  of  GROUP)  and  UNDEFINFD  names  should 
be  resolved,  this  parameter  identifies  these  incomplete  aspects 
of  the  structures. 

For  a complete  set  of  final  specifications  for  a particular 
target  system,  the  report  may  be  generated  to  present  the 
logical  information  structures  to  be  handled  by  the  target.  For 
this  purpose  it  is  recommended  that  the  report  be  generated  for 
all  SET  names  with  LEVFLS=2  so  that  the  relationships  among 
INPUTS,  OUTPUTS  and  ENTITIES  with  SETS  can  be  presented,  and 
generated  for  all  INPUT,  OUTPUT  and  ENTITY  names  so  that 
structures  below  these  names  can  be  viewed.  The  commands  to 
generate  this  information  are: 

NAME-GEN  3=*SET* 

CONTENTS  LEVEL3=2 


NAME-GEN  S=*INPUT  OR  OUTPUT  OR  ENTITY*  CFDER  = B YTY PE 

CONTENTS 


the  BYTYPE  option  is  used  so  that  all  names  of  a particular  name 
type  are  defined  together. 

When  the  volume  of  information  which  will  be  presented  by  the 
CONTENTS  EE PORT  is  unknown,  it  is  a good  practice  to  be 
conservative  in  specifying  a value  for  LEVELS  rather  than  allow 
LEVELS  to  have  the  value  ALL  and  risk  the  possibility  of 
generating  dozens  of  pages  of  output. 
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■Saanelas 

Figure  23  presents  the  full  data  structure  for  the  name 
hourly-employee-record . This  example  was  produced  by  the 
followinq  command: 

CONTENTS  NAKE  = hotirly- employee- re  port 

Figure  24  presents  the  data  structures  down  to  level  2 for  all 
ENTITIES  defined  in  a particular  Analyzer  data  base.  The 
Analyzer  commands  used  to  generate  this  example  were: 

NAFE-GFN  S*' ENTITY • 

CONTENTS  LEVEL 5=2 
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Pur£2se 


This  report  shows  the  interaction  between  information  (SETS, 
INPUTS,  OUTPUTS,  ENTITIES.  GFOUPS  and  ELEMENTS)  defined  and  ' 


INPUTS,  OUTPUTS,  ENTITIES,  GFOUPS  and  ELEMENTS)  defined  and  the 
PROCESSES  defined  for  the  target  system.  It  also  shows  the  data 
dependencies  among  FFOCESSES  as  implied  by  the  language 
descriptions  of  the  PROCESSES  and  possible  deficiencies  in  the 
descriptions  of  these  PROCESSES. 


Information  Presented 


The  information  presented  in  thi 
depending  on  whether  the  DATA  or 
generating  the  report. 


this  report  is  sliqhtly  different 
or  PROCESS  parameter  . was  used  in 


If  the  DATA  parameter  is  used  in  generating  the  report,  the 
names  used  as  input  must  be  SETS,  INPUTS,  OUTPUTS, 

GROUPS  and/or  ELEMENTS  and  the  report  presents  all 
PROCESSES  which  manipulate  the  input  names  via  the 
USED,  UPDATED,  DFFIVED  and  GENEFATEC  statements  in 
Analyzer  data  base. 


ENTITIES, 
t hose 
FECFIVED, 
a particular 


If  the  PROCESS  parameter  is  used  in  generating  the  report,  rhe 
names  used  as  input  must  be  PROCESS  names  an  5 the  report 
presents  all  those  SFT,  INPUT,  OUTPUT,  ENTITY,  GROUP  and  ELEMENT 
names  that  each  input  PPOCESS  name  manipulates  via  the  FECFIVES, 
USES,  UPDATES,  DERIVES  and  GENEF  ATFC  statements  in  a particular 
Analyzer  data  base. 


The  interactions  among  lata  and  PPOCFSSES  are  shown  as  a matrix. 
An  analysis  on  this  matrix  presents  a summary  describing  the 
incomplete  aspect  of  the  Language  description  with  respect  to 
the  information  presented  in  the  matrix.  For  example,  a PPOCESS 
producing  information  without  using  any  information  would  be 
identified  in  this  summary. 


A second  matrix  presents  the  manner  in  which  the  PROCESSES 
(presented  in  the  first  matrix)  interact,  i.e.,  how  they  depend 
on  data  produced  by  other  PROCESSES.  Again,  the  information  in 
this  matrix  is  derived  from  the  information  in  the  first  matrix. 


Finally,  an  analysis  is  performed  on  this  matrix  and  presented 
in  the  form  of  a summary.  The  summary  identifies  those 
PROCESSES  with  no  predecessors  (i.e.,  do  not  USE  or  FFCFIVF  data 
produced  by  other  PFOCESSES)  and  those  with  no  successors  (i.e., 
do  not  DERIVE,  UPDATE  or  GENEFATF  any  data  used  by  other 
PFOCESSES) . 


The  two  summaries  and  the  second  matrix  are  al).  produced  based 
on  the  information  presented  in  the  first  matrix.  Therefore, 
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items  which  are  design  \ ♦•ed  incomplete  in  the  report  nay  actually 
h»-  resolved  elsewhere  in  the  description  in  the  data  base.  For 
example,  it  the  following  description  was  in  the  data  base: 

PROCESS:  pay  col 1- process inq ; 

USES : employee- information; 

DERIVES:  paysy stem- out  puts ; 

and  the  DATA  PROCESS  FEP0F7  was  produced  for  the  name 
employee- inf otmation,  the  PROCESS  payroll-processing  would  he 
presented  since  it  USES  it.  The  report  would  then  identify 
pay roll- processing  as  USING  data  but  not  UPDATING  or  DERIVING 
anything  though  elsewhere  in  the  description  it  does.  For  this 
reason,  it  is  important  to  recoqnize  that  the  comments  in  the 
report  are  made  with  respect  to  the  information  in  the  first 
matrix  rather  than  the  entire  description  as  it  exists  in  the 
data  base. 


1 

1 

fl 


Format 

Two  lists  of  names  are  first  presented,  one  labeled  FOW  NAMES 
and  the  other  COLUMN  NAMES.  If  the  DATA  parameter  was  used  in 
generating  the  report,  the  names  designated  as  FOW  NAMES  are 
those  which  were  giver,  as  input.  If  the  PROCESS  parameter  was 
used  in  generating  the  report  the  names  designated  as  COLUMN 
NAMES  are  those  which  were  qivon  as  input. 

In  any  case,  each  name  under  COLUMN  NAMES  in  some  way  (RECEIVES, 
USES,  etc.)  interacts  with  tero  or  more  names  given  under  FOW 
NAMES  and  each  name  under  FOW  NAMES  is  manipulated  (USED, 
DERIVED,  etc.)  by  zero  or  more,  FFOCESS  names  qiven  under  COLUMN 
NAMES. 

The  DATA  PROCESS  INTERACTION  MATRIX  is  then  printed  out  to  show 
the  relationships  between  the  names  designated  as  ROW  NAMES 
(which  are  represented  by  the  rows  of  the  matrix)  and  the  names 
designated  as  COLUMN  NAMES  (which  are  represented  by  the  columns 
of  the  matrix).  The  rows  and  columns  of  the  matrix  are  numbered 
to  correspond  to  the  number  assigned  to  each  name  in  the  list  of 
FOW  NAMES  and  COLUMN  NAMES,  respectively. 

An  entry  (F , U,  D,  A,  F,  1 or  2)  at  the  intersection  of  a 

particular  row  and  column  ot  the  matrix  designates  that  the  name 

represented  by  the  row  is  manipulated  in  some  way  (as  defined  by 

the  meaning  ot  the  entry)  by  the  name  represented  by  the  column. 

A legend  is  provided  as  part  of  the  report  that  defines  the 
meaning  of  each  possible  entry.  This  leqend  is  shown  below  for 
purposes  of  clar i f icat ion . 


1L  y^lu e 
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- msmma  * 


iir 


0 

D 

A 

F 

1 

2 


mean  j.  no 

Row  i is  received  or  used  by  column  1 
(input) 

Row  i is  updated  by  column  j 

Row  i is  derived  or  generated  by  column  j 

(out  put) 

Pow  i is  input  to,  updated  by,  and  output 
of  column  j (all) 

Pow  i is  innut  to  and  output  of  columr  -j 
(flow) 

Row  i is  input  to  and  updated  by  column  j 
Row  i is  updated  by  and  output  of  column 
1 


A summary  section  called  the  DATA  PROCESS  INTERACTION  MATRIX 
ANALYSIS  is  then  presented  specifying  those  inconsistencies 
found  in  analysis  of  the  DATA  PROCESS  INTERACTION  MATPIX. 
Inconsistencies  for  ROW  NAMES  and  COLUMN  NAMES  are  handled 
separately.  Inconsistencies  found  for  POW  NAMES  are  presented 
under  the  DATA  heading  and  are  of  the  following  format: 


row  name  (name-type)  (row  number)  inconsistency  message 

Inconsistencies  found  for  COLUMN  NAMES  are  presented  under  the 
PROCESS  headinq  and  are  of  the  following  format: 

column  name  (row  number)  inconsistency  message 

No  name-tyne  is  necessary  because  all  names  under  COLUMN  NAMFS 
are  PROCESSES. 


A second  matrix,  the  PROCESS  INTFPACT10N  MATRIX,  is  printed  to 
show  relationships  implied  between  PROCESSES  in  the  DATA  PFOCESS 
INTERACTION  MATRIX,  In  this  matrix  both  the  rows  and  columns 
represent  those  PROCESS  names  listed  under  COLUMN  NAMES  and  the 
rows  and  columns  are  numbered  tc  correspond  to  the  appropriate 
name  in  COLUMN  NAMES. 

An  asterisk  (*)  entry  at  the  intersection  of  a particular  row 
and  column  of  the  matrix  designates  that  the  PFOCESS  represented 
by  the  row  DPR  IVES  or  UPDATES  some  information  which  is  USED  by 
the  PPOCESS  represented  by  the  column, 

A summary  section  called  the  PPOCESS  INTERACTION  MATRIX  ANALYSIS 
then  presents  observations  on  the  infoimation  in  the  PPOCESS 
INTERACTION  MATRIX.  These  observations  are  presented  in  the 
following  format: 

process  name  (row  or  column  number)  observation 

An  observation  is  given  for  each  PRCCtES  which  does  not  use 
information  produced  by  any  of  the  other  PROCESSES,  or  does  not 
produce  information  used  by  any  of  the  other  PROCESSES. 


Part  III  UFA  Outputs 


UFA  User's  Manual 


156 


Options  and  Alternatives 

The  report  must  he  qenerated  usinq  either  the  DATA  or  PFOCESS 
parameter.  If  the  DATA  parameter  is  used,  all  names  given  as 
input  must  bu  SET,  INPUT,  OUTPUT,  ENTITY,  GFOUP  and/or  ELEMENT 
names.  If  the  PKOCFSS  parameter  is  used,  all  names  given  as 
input  must  he  PFOCESS  names. 


Various  sections  of  the  report  can  he  printed  or  left  out 
dependinq  on  the  parameters  used  when  generating  it.  These 
parameters  and  their  effects  are  presented  below: 


1) 

DP  MAT 

m 

the  DATA  PFOCESS  INTERACTION  HATPIX  is 
included  in  the  report 

NODPMAT 

- 

the  matrix  is  not  printed 

2) 

DPANL 

- 

the  DATA  PFOCESS  INTERACTION  MATFIX 
ANALYSIS  included  in  the  report 

NODPANL 

- 

the  analysis  is  not  printed 

3) 

PM  AT 

am 

the  PFOCESS  INTERACTION  MATRIX  is 
included  in  the  report 

NOPMAT 

•m 

the  matrix  is  not  printed 

4) 

PA  NL 

- 

the  PFOCESS  INTEFACTION  ANALYSIS  is 
included  in  the  report 

NOPANL 

- 

the  analysis  is  not  printed 

The  report  may  be  generated  for  a single  input  name  (via  the 
name  parameter)  or  for  a collection  of  input  names  either 
specified  by  the  user  or  retrieved  via  NAME-GEN. 

I 

Analysis 

Each  name  given  as  input  is  searched  for  in  the  data  base.  If 
it  is  not  round,  the  messaqe: 

UP A 143: MAIN  DP:  NAME  NOT  IN  D. B.- 

is  printed.  If  the  name  is  found  and  the  DATA  parameter  is 
used,  the  name  is  checked  that  it  is  a SET,  INPUT,  ENTITY,  GFOUP 
or  ELEMENT  name.  If  it  is  not,  the  message: 

UF  A1 34 : KA I NDP:  INVALID  INPUT  NAME  TYPE 

is  printed  and  the  name  is  not  included  in  the  matrix. 

It  the  DATA  parameter  is  used,  all  PFOCESS  names  which  PECEIVE, 
USE,  UPDATE,  DEFIVE  and/or  GENEFATI  each  input  name  are  found. 
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The  list  of  all  input  names  and  the  list  of  ill  PROCESS  names 
found  are  then  printed  on  the  report. 

If  the  PROCESS  parameter  is  used,  all  SET.  INPUT.  OUTPUT, 

ENTITY,  GPOUP  and/or  ELEMENT  names  which  interact  with  each 
input  name  are  found.  The  list  of  all  input  names  ar.d  the  list 
of  all  SET,  INPUT,  OUTPUT,  ENTITY,  GPOUP  and  ELEMENT  names  found 
are  then  printed  on  the  report. 


The  DATA  PROCESS  INTERACTION  MATRIX  is  then  printed  with  the 
appropriate  value  (F,  U,  D,  A,  F,  1 or  2)  designating  a 
relationship  between  a column  name  and  row  name. 


The  matrix  is  then  analyzed  and  inconsistency  messages  are 
printed  as  data  diagnostics  (for  row  names  representing  SET, 
INPUT,  OUTPUT,  ENTITY,  GPOUP  and/or  ELEMENT  names)  and  process 
diagnostics  (for  column  names  representing  FFCC3SS  names) . 

These  diagnostics  are  presented  below  cateqorized  by  the  name 
types  to  which  they  may  apply. 


I.  DATA  DIAGNOSTICS  (ROWS) 

1)  INPUT  names 

- not  PECEIVED  by  any  PPOCESS 

If  no  PROCESS  names  FECEIVE  the  INPUT  name  of  interest, 
this  diagnostic  is  printed.  If  at  least  one  FROCESS 
RECEIVES  the  INPUT  name,  the  message  is  not  printed. 

- not  USED  by  any  PROCESS 

If  no  PPOCESS  USES  the  INPUT  name  of  interest,  this 
diagnostic  is  printed..  If  at  least  one  FROCESSES  USES  the 
INPUT  name,  the  message  is  net  printed. 


2)  OUTPUT  names 

- not  GENERATED  bv  any  PROCFSS 

If  no  PROCESS  names  GENERATE  the  OUTPUT  name  of  interest, 
this  diagnostic  is  printed.  If  at  least  one  PPCCESS 

GENEFATES  the  OUTPUT  name,  the  message  is  not  printed. 


- not  DERIVED  by  any  PFOCESS 

If  no  PPOCESS  names  DERIVE  the  OUTPUT  name  of  interest, 
this  diagnostic  is  printed.  If  at  least  one  PFCCESS 
DERIVES  the  OUTPU"’  name,  the  message  is  not  printed. 


3)  ENTITY  or  SET  names 

- not  DEFIVFD  by  any  FROCESS 
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It  no  PFOCE.SS  rames  LERIVE  the  ENTITY  or  SET  name  of 
interest,  this  diagnostic  is  printed.  If  at  least  one 
PROCESS  DERIVES  the  name,  the  Message  is  not  printed. 

- DEFIVED  but  not  USED  by  any  PROCESS 

If  at  least  one  PROCESS  name  DERIVES  and  no  PROCESS  names 
USE  the  ENTITY  or  SET  name  of  interest,  then  this 
diagnostic  is  printed.  There  are  3 conditions  that  will 
cause  this  message  not  to  be  printed. 

i)  the  name  is  not  DERIVFD  by  any  PROCESS. 

ii)  the  name  is  USED  by  at  least  one  PROCESS. 

iii)  both  i and  ii. 

- UPDATED  but  rot  USED  by  any  PFOCESS 

If  at  least  one  PROCESS  UPDATES  and  no  PFCCSSS  USES  the 
ENTITY  or  SET  name  ot  interest,  this  diagnostic  is  printed. 
There  are  3 conditions  that  will  cause  this  message  not  to 
be  printed: 

i)  the  name  is  not  UPDATED  by  any  PROCESS. 

ii)  the  name  is  U5FD  by  at  least  one  PFOCESS. 

iii)  both  i and  ii. 

4)  GROUP  or  ELEMENT 

- not  DERIVED,  UPDATED,  or  USED  by  any  PROCESS 

If  no  PFOCcSS  nam  >s  DFFIVE,  UPDATE  or  USE  the  GFOUP  or 
ELEKENT  name  of  interest,  this  diagnostic  is  printed. 

There  are  several  conditions  that  will  cause  this  messaqe 
not  to  be  printed: 

i)  a*  least  one  PROCESS  DERIVES  the  name. 

ii)  at  least  one  PFOCESS  UPDATES  the  name. 

iii)  at  least  one  PROCESS  USES  the  name. 

iv)  all  3 or  any  combination  of  the  above. 

NOTE:  it  is  only  necessary  that  one  of  the  first  3 
conditions  is  satisfied  for  the  message  rot  to  be  printed. 

II.  BBQS5?S  DIAGNOSTICS  (COLUMNS) 

• does  not  interact  with  any  data 


4 


. 


1 
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If  the  PFOCESS  of  interest  does  not  interact  with  any  SET, 
INPUT,  OUTPUT,  ENTITY,  GROUP  or  ELEMENT  names,  this  diagnostic 
is  printed.  If  at  least  one  name  interacts  with  this  PFOCFSS, 
this  message  is  not  printed. 


- USES  data,  but  does  not  DERIVE  or  UPDATE  anything 

If  the  PROCESS  of  interest  USES  at  least  one  SET,  INFUT,  ENTITY, 
GROUP  or  ELEMENT  name  and  does  not  DEFIVF  or  UPDATE  any,  this 
diagnositc  is  printed.  There  are  several  conditions  where  this 
messaqe  will  not  be  printed: 

i)  the  PROCESS  does  not  USP  anv  SET,  INPUT,  ENTITY,  GFOUP  or 
ELEMFNT . 


ii)  the  PROCESS  DEFIVES  at  least  one  SET,  OUTPUT,  ENTITY,  GFOUP 
or  ELEMENT. 


iii)  the  PROCESS  UPDATES  at  least  one  SET,  ENTITY,  GFOUP  or 
ELEMENT. 

iv)  all  3 or  any  combination  of  the  above. 

- DERIVES  something  but  does  not  USE  anything 


If  the  PROCESS  of  interest  DERIVES  at 


GROUP 

’ or 

ELEMENT 

and 

does 

not  US? 

any. 

printed . 

There 

are  3 

conditions 

where 

print 

ed: 

i) 

the 

PROCESS 

does 

not 

DERIVE 

any  S 

or  E 

LEMENT. 

ii) 

the 

PFOCESS 

USES 

at 

least  or 

e SET 

ELEM 

ENT. 

iii) 

both 

i and 

ii. 

least  one  SET,  ENTITY, 
this  diagnostic  is 
this  message  will  not  be 


ET,  OUTPUT,  ENTITY,  GROUP 
, INPUT,  ENTITY,  GROUP  or 


- UPDATES  something  but  does  not  USE  anything 

If  the  PROCESS  of  interest  UPDATES  at  least  one  SET,  ENTITY, 
GROUP  or  ELEMENT  and  does  not  USF  any,  this  liagnostic  is 
printed.  There  are  3 conditions  where  this  message  will  not  be 
printed : 


i)  the  PFOCESS  does  not  UPDATE  any  SET,  ENTITY,  GROUT  or 
ELEMENT. 


ii)  the  PROCESS  USES  at  least  one  SET,  INPUT,  ENTITY,  GROUP  or 
ELEMENT. 


iii)  both  i and  ii. 


1 
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The  PROCESS  INT&FACTION  MATRIX  is  then  produced  using  the  data 
in  the  first  matrix.  The  entries  in  a given  column 
(representing  a PFOCESS  name)  of  the  DATA  PROCESS  I NTEP ACTION 
MATRIX  are  compared  with  the  entries  for  each  other  column.  If 
an  entry  in  the  qiven  column  designates  that  the  PROCESS  USES 
information  which  is  DERIVED  or  UPDATED  by  the  column  being 
compared  with,  an  * entry  is  made  in  the  PFOCESS  INTERACTION 
matrix  at  the  column  or  row,  respectively,  representing  these 
two  PROCESS  names.  The  matrix  is  then  analyzed  and  observations 
are  produced  from  this  analysis.  These  observations  are 
presented  below. 

- no  interaction  with  other  FPOCESSFS 

If  a PROCESS  does  no*-  USE  an  object  and  also  does  not  DERIVE  or 
UPDATF  an  object,  this  diagnostic  is  printed.  There  are  3 
conditions  that,  will  cause  this  message  not  to  be  printed: 

i)  the  PROCESS  USES  at  least  one  SSI,  INPUT,  INTITT,  GROUP  or 
ELEMENT. 

ii)  the  PROCESS  UPDATES  or  DERIVES  a SET,  OUTPUT,  ENTITY,  GROUP 
or  ELEMENT. 

iii)  both  i and  ii. 

- no  predecessors  for  this  PROCESS 

If  the  PROCESS  of  interest  does  not  USE  any  objects  but  DERIVES 
or  UPDATES  at  least  on°  object,  this  diagnostic  is  printed.  The 
3 conditions  that  will  cause  this  message  r.ot  to  be  printed  are: 

i)  the  PROCESS  USES  at  least,  one  SET,  INPUT,  ENTITY,  GROUP  or 
EL  EM  FN  T . 

ii)  the  PFOCESS  does  not  DERIVE  or  UPDATE  any  SETS,  OUTPUTS, 
ENTITIES,  GROUTS  or  ELEMENTS. 

iii)  both  i and  ii. 

- no  successors  for  this  PROCFSS 

If  the  PROCFSS  of  interest  USES  at  least  one  object  but  does  not 
DERIVE  or  UPDATE  any  object,  this  diagnostic  is  printed.  The  3 
conditions  that  will  cause  this  message  not  to  be  printed  are: 


i) 

the  PFOCESS  does  not  USE  any  SETS, 
or  ELEMENTS. 

INPUTS,  ENTITIES,  GROUPS 

¥ 

ii) 

the  PROCESS  DEFIVSS  or  UPDATES  at 
ENTITY,  GROUP  or  ELEMENT. 

least  one  SET,  OUTPUT, 

iii) 

both  i and  ii. 
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Usage 


When  the  ronort.  is  generated  usinq  the  DATA  parameter,  it  aids 
in  presenting  the  utilization  of  SET,  INPUT,  OUTPUT,  ENTITY, 
GROUP  and  ELEMENT  names  defined.  This  aids  in  identifying  which 
names  are  not  being  utilized.  For  those  names  which  are  being 
utilized,  it  presents  all  the  PROCESS  names  which  utilize  them. 


t 


When  the  report  is  generated  usinq  the  PROCESS  parameter,  it 
presents  all  the  data  required  for  each  particular  PROCESS.  It 
also  aids  in  identifying  PROCESS  names  which  do  not  interact 
with  data  or  are  not  consistently  defined  with  respect  to  the 
manner  in  which  they  use  data. 

The  PROCESS  INTERACTION  MATRIX  may  be  used  by  designers  to  plan 
out  the  logic  of  the  target  system  because  it  presents  the  data 
dependencies  among  the  PROCESSES  defined. 

The  following  completeness  checks  can  be  made  for  a target 
system  description  based  or.  information  presented  in  the  repor*: 

- ALL  INPUTS  RECEIVED  by  some  PROCESS 

- ALL  INPUTS  USED  by  some  PROCESS 

- ALL  OUTPUTS  GENERATED  by  some  PROCESS 

- ALL  OUTPUTS  DERIVED  by  some  PROCESS 

- ALL  ENTITIES  and  SETS  DEFIVED  by  some  PROCESS 

* ALL  ENTITIES  and  SETS  ULFIVFD  and  USED  by  some  PROCESS 

- ALL  ENTITIES  and  SETS  are  UPDATED  and  USED  by  some  PFOCESS 

- ALL  GROUPS  and  ELEMENTS  are  DEFIVED  or  UPDATED  or  USED  by  some 
PPOCESS 

- ALL  PROCESSES  USE  data  and  DEF I V"  or  UPDATE  data 

- ALL  PROCESSES  which  DERIVE  data  also  USE  data 

- ALL  PROCESSES  which  UPDATE  data  also  USE  data 

- ALL  PROCESSES  interact  with  data  in  some  way 

The  report  may  also  be  used  to  aid  in  determining  if  the 
description  of  the  target  system  was  specified  consistently  with 

respect  to  the  use  of  lanquage  statements.  In  particular,  it 
determines: 

- whether  or  not  the  use  of  FECEIVES  and  GENERATES  statements 
in  describing  the  system  flow  aspect  of  the  system  is 

consistent. 
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- whether  or  not  th<  use  of  USES,  UPDATES',  and  DERIVES  statement 
in  describing  the  data  derivation  aspect  ot  the  system  is 
consistent . 


Examples 

Figure  25  presents  the  DATA  PROCESS  FEPORT  generated  for  all 
INPUT,  OUTPUT  and  ENTITY  names  defined  for  a particular  target 
system  description.  This  example  was  produced  using  the 
Analyzer  commands: 


NAME-GEN  S=»INPUT  OP  OUTPUT  OB  ENTITY* 
OATA-PFOCESS  DATA 

Figure  “ j presents  the  report  generated  for  low  level  PROCESSES 
defined  in  the  description.  These  PROCESSES  were  identified  by 
the  KEYWORD  "terminal"  and  the  report  was  produced  by  the 
following  Analyzer  commands: 

NA Mt-GEN  S= ' PFOCESS  AND  KEY*terminal* 

DATA- PROCESS  PFOCESS 

Note  that  no  reports  of  omissions  appear  in  this  figure  under 
Data  Process  Interaction  Matrix  Analysis  because  at  least  one 
condition  for  the  names  listed  is  satisfied. 
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Purpose 

This  report  presents  l^fir.itions  attached  tc  names  used  in  a 
Language  description  and  is  intended  as  an  aid  in  communication 
among  persons  interested  in  the  description. 


Ir.f  orma  ti  on  Presente  1 

This  report  prints  out  the  following  information  about  each  name 
used  as  input  when  generating  the  report  and  the  appropriate 
parameters  are  used: 

- Name  type  of  *ho  name 

- DESCFI PTICN  comment  entry  for  the  name 

- SYNONYMS  associated  with  the  name 

- RESPONSIBLE  PROBLEM  DE  FINE  F for  the  name's  description 

- KEYWORDS  associated  with  the  name 

All  of  the  above  information  is  readily  available  from  the 
cortents  of  the  data  base. 


Format 

A dictionary  entry  is  presented  for  each  name  given  as  input  to 
the  software  producing  the  report.  The  first  line  of  each  entry 
consists  of: 

- A number  designating  the  order  the  name  was  read  from  the 
input  (and  consequently  presented  in  the  report) 

- The  name  the  ^ntry  is  for 

- "he  name  type  of  the  name 

The  DESCRIPTION,  SYNONYM,  KEYWOFDS  and 

Pf SPONSIBLe>P?OBLTK~DEFINFP.  statements  for  each  name  are 
presented  in  the  following  format  after  the  first  line  of  the 
entry : 

DESCRIPTION : 

[ DFSCF  I PTICN  comment,  entry] 

SYNONYMS:  [all  SYNONYMS  for  the  name  listed  two  per  line] 
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KEYWORDS : [all  KEYWORDS  for  the  name  listed  two  per  line] 

FLSP  FD:  [PFOBLEK  DFFINEF  name] 

Spacinq  between  dictionary  entries  nay  be  modified  by  the 
NOM-SPACl  PARAMETER. 


Options  and  Alternatives 

The  number  of  lines  skipped  between  dictionary  entries  is 
specified  by  the  NUK-SPACE  parameter.  By  default,  3 lines  are 
skipped  but  NUJS-SPACE  nay  take  ary  value  C through  10. 

The  different  types  of  information  presented  in  a report  entry 
can  be  included  m or  left  out  of  the  report  depending  on  the 
parameters  used  when  generating  it.  Each  parameter  and  its 
effect  is  presented  below: 

1)  DESCRIPTION  - the  DESCRIPTION  comment  entry  for 

each  name  is  printed 

NODESCRIPTION  - DESCRIPTION  comment  entries  are  not 

printed 

2)  KEYWORDS  - all  KEYWORDS  associated  to  each 

name  is  printed  out 

NOKEYWOFDS  ••  KEYWOFDS  are  not  printed 

3)  RESPONSIBLE-PD  - the  FESDGN  S1BLE- PROELEM-DFFINEF  for 

each  name  is  printed 

NOFESPONSIBI. E-PD  - RESPONSIBLE-  PFOELEK-DEFINEFS  are 

not  printed 


UFA064:  KAINDICT:  NAKF  NOT  FOUND  IN  D.B.- 


is  printed.  If  the  name  is  found,  the  information  specifieJ  1 v 
the  parameters  for  the  command  is  retrieved  if  available  for  the 
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Usage 


The  report  is  a valuable  aid  to  analysts  in  maintaining 
definitions  for  names  in  the  data  base  and  as  a tool  for 
communicating  with  users  of  tho  target  system.  The  DESCPIFTIONS 
for  each  r.in»?  may  he  approved  or  disapproved  by  the  users  with 
respect  to  what  the  users  require  of  the  target  system.  As 
DESCRIPTIONS  art  modified,  the  analyst  can  add,  delete  or  modify 
other  statements  to  correspond  to  the  DESCF IPTIONS. 

If  conventions  are  imposed  on  the  language  description  required 
for  particular  types  of  names,  an  effective  data  dictionary  can 
he  formed.  For  example,  by  requiring  certain  KEYWORDS  to  be 
assigned  to  GROUP  and  2 LEM I NT  names  and  that  each  GROUP  and 
ELEMENT  name  have  a DESCFJ PTICN , the  DICTIONAFY  FEPOFT  would  be 
a good  reference  for  anyone  interested  in  the  data  described  in 
the  target  system. 


Examples 

Fiquro  27  presents  the  niC'IIONAPY  PFPOFT  for  a single  PROCESS 
name.  This  example  was  produced  by  the  command: 

PICTION A P Y NAME  = payroll- processing 

Fiqure  23  presents  the  report  for  several  PROCESS  names  which 
have  the  KFYWOSD  'independent'.  This  example  was  produced  by 
the  following  Analyzer  commands: 

NAME-GEN  S*' PROCESS  AND  KEY=independent' 

DICTIONAFY 
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This  report  shows  the  INPUTS,  EVENTS,  CONDITIONS  And  PFOCESSFS 
that  influence  what  activities  (PROCESSES)  will  be  performed  and 
the  order  in  which  they  ar»  performed  in  the  tarqet  system.  It 
also  indicates  the  dependencies  of  the  system  dynamics  on  the 
condition  of  other  system  oblects.  The  relationships  depicted 
are  TRIGGERS,  IN  TEE i UP  TS  , TERM!  NATFS,  CAUSES,  FAKES, 
BECOMING-TRUE/ FALSE,  and  optionally  UIIUV’.FS. 


Infocmgtjqn  Presented 

»or  each  PROCESS,  EVENT,  CONDITION  and  INPUT  name  given  as  input 
or  obtained  internally  from  the  relationships,  the  report 
presents,  in  tne  form  of  .»  matrix,  all  objects  dynamically 
related  to  the  given  object.  ^or  each  PROCESS  given,  the  report 
shows  those  PROCESSES  that  M»e  given  oblect  TUGGERS , TEF MI  NATES 
or  INTERRUPTS,  rhose  EVENTS  that  I VCSPTiON-CA USES  or 
IE RUINATION "CAUSES  and  those  CONDITIONS  that  the  given  process 
HAKES  TRUE  or  FAKES  FALSE. 

Similarly,  for  each  INPUT  and  EVEN""  given,  the  report  shows 
those  PROCESSES  that  the  given  oblect  TRIGC.fcFS,  TtPF.INATES  or 
INTERRUPTS,  and  optionally  UTJLITEf  those  EVENTS  that  the  given 
oblect  CAUSFS  and  the  CONDITIONS  that  the  given  objec*  F.AKFS 
TRUE  or  MAKES  FALSE.  For  each  CONDITION  object  given,  the 
report  indicates  those  PFOCESSFS  tor  which  the  condition 
BECOMING  TRUE  or  BECOMING  FALSE  tpic.GLRS,  TERMINATES  or 
INTERRUPTS,  and  those  events  for  which  the  condition  BE CO MI  NO 
TRUE  or  BECOMING  FALSE.  CAUSES. 

This  report  is  unlike  some  of  the  other  A r. a 1 y ? e t reports  in  that 
a single  input  name  could  add  many  names  to  both  the  rows  and 
columns  of  the  matrix.  This  is  because  the  particular  oblect 
could  be  dynamically  related  to  many  other  objects,  those  in 
turn  dynamically  related  to  other  objects,  and  so  on.  The 
dynamic  analysis  thus  proceeds,  in  essence,  down  the  "tree"  or 
chain  of  events,  processes  and  conditions  for  each  name  given  as 
input.  Therefore,  there  is  not  a one-to-one  correspondence 
between  the  number  of  names  provided  in  the  input,  and  the 
number  of  names  in  the  rows  and  columns  of  the  matrix.  There 
will  likely  be  more  names  in  the  matrix  than  specified  in  the 
input. 

An  analysis  is  then  performed  on  t b*»  matrix.  Certain  potential 
incompletenesses  and  inconsistencies  ot  the  target  system 
description  are  determined  by  the  analysis  and  signaled  to  tie 
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c through  appropriate  diagnostic  messages. 


Fot  ma» 

Two  lists  of  names  are  first  presented,  onv  labeled  low  names, 
the  other  labeled  column  names.  The  row  names  consist  ot  those 
names  that  «ni«  given  as  input  plus  all  other  names  found  during 
the  processing.  The  column  names  are  in  some  way  affected  by 
the  row  names,  «?.<!.,  TF. IUGEF. FD  BY,  CAUSED  BY,  o*c.  (See  Table  1 
below)  The  object  type  of  each  name  appears  beside  it  in  the 
co  1 uran . 

The  DYNAMICS  ANALYSIS  MATFIX  is  then  printed  to  show  the 
relationships  h«  ♦ wot  n the  names  designated  as  FCW  NAMES  (which 
are  represent*' l by  t h^  rows  ot  the  matrix)  and  the  names 
designated  as  column  (which  are  represented  by  the  columns 

of  the  matrix).  Tin  rows  and  columns  of  the  matrix  are  numbered 
to  correspond  to  the  number  assigned  to  each  name  in  the  list  of 
LOW  NAMES  anl  COLUMN  NAMES,  respect i vel y . The  order  of  the  rows 
and  columns  will  bo  by  object  typo  unless  specifically  directed 
otherwise  usir.q  the  PS  PL  P parameter. 

An  entry  a*  the  intersection  of  a particular  row  and  column  of 
the  matrix  desiomtes  that  the  name  represented  by  the  column  is 
affected  in  som»*  way  by  the  name  represented  by  the  row.  A 
legend  is  provided  ar,  nart  of  tbe  report  that  defines  the 
moaning  ot  each  possible  entry.  This  legend  is  shown  below  in 
Table  1. 


Ji.-JL 

Mean i nq 

A 

Sow 

i 

TFIUGE’FS  Column  j 

p 

Fow 

i 

INTERRUPTS  column  j 

C 

Fow 

i 

ISSKINATFS  Column  1 

D 

Fow 

i 

CAUSES  Column  j 

7 

Fow 

i 

VAK1 S TP UF  Column  j 

F 

Fow 

i 

MAKES  FAI.SF  Column  j 

Fow 

i 

BSCCN1 NG-TPUF- IF IGGERS  Column  1 

l» 

Fow 

i 

BFCOMING-TR  UF-1 N TEFR UPTS  Column 

I 

Fow 

i 

BFCOKINU-'tpnF- TERMINATES  Column 

d 

Fow 

i 

RECONING-TF  UF— C A USES  Column  j 

K 

Fow 

i 

BSCuKING-FALSE-T  RIGGERS  Column  j 

L 

Fow 

i 

BECOMING- FALSE- i NTER  FUPTS  Column 

M 

Sow 

i 

BECOMING- FALSE- TERMINATES  Column 

N 

Fow 

i 

BSCGMING-FAI  SF.-CAUSES  Column  j 

0 

Fow 

i 

INCF  TT ION- CAUSES  Column  1 

P 

hOW 

i 

r:'PM:NA"inN-CAUSES  column  j 

0 

1 ow 

i 

UTILIZES  Column  j 

V 

Fow 

i 

is  the  same  name  as  Column  j 

TABLE  1 

- 

system  Dynamics  Felation shi ps 
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In  addition  to  the  codes  above,  t he  presence  of  a numerical 
suffix  indicates  that  ^ ho  declared  action  is  either  conditional 
(may  or  say  not  happen  DEPENDING  on  sonu  condition  or  element) 
or  repetitive  (happening  FOF  ?ACM  rased  object  instance)  or 
both.  The  suffixes  are: 

SUlLii  Value  5£±QiJ3dl 

1 Conditional  (CiPESPlNtt  lN) 

2 Fepetitive  (FOF  EACH) 

3 noth  of  the  above 

A Maximum  of  twenty-five  rows  and  thirty  columns  is  printed  per 
page  for  the  Dynamic  Analysis  Matrix.  should  more  than  thirty 
columns  he  necessary,  the  additional  columns  will  appear  on 
consecutive  pages  in  groups  of  thirty.  how  continuations  will 
appear  on  succeeding  pages,  with  all  columns  printing  tor  each 
additional  group  of  lows. 


A summary  section  called  the  DYNAMIC?  ANALYSIS  is  then  presented 
specifying  possible  incompletenesses  and  i nconsistuncies  found 
in  the  analysis  of  the  matrix. 

The  diagnostics  are  printed  in  three  groups.  First,  the  column 
incompleteness  messages  will  be  printed  in  the  format: 

object-name  name-typo  column- number  incompleteness- message 

Then  the  row  incompleteness  messages  will  bo  printed  in  the 
format : 


oblect-name  name- type  row-number  incompleteness-message 

The  possible  i ncompieteness  messages  aie  described  below  under 
Analysis. 


The  inconsistency  messages  are  the  last  to  be  printed.  Thcv 
have  the  format; 


object-name-1  AND  object-name- 2 NAY  D f.  DYNAMICALLY  I NCC NS T STPK T 


2£iions  and  Ali^rn^Hv^s 

The  report  may  be  generated  for  a single  input  name  (via  the 
NAME  parameter)  or  for  a collection  of  input  names  either 
specified  by  the  user  or  retrieved  by  N A ME-GP  N . 

The  matrix  and  analysis  sections  of  the  report  can  be  printed  or 
omitted  depending  on  the  parameter  values  specified.  »hese 
parameters  and  their  effects  are  presented  below. 
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1)  DYNAMIC- ANALYSIS-.':  Air  IX  (DAM  AT) 

the  DYNAMICS  ANALYSIS  MATFIX  is  included 
in  th^>  report  (this  is  the  default) 

NODYNA’IIC-ANALYFLF-MATFIX  (N  P AM  AT) 

- the  matrix  is  net  printed 

2)  TYNAKICS-ANALYSIS  (DANL) 

the  DYNAMICS  ANALYSIS  messages  are  included 
in  the  report  (this  is  the  default) 

NODYNAMICS-ANALYSIS  (NDANL) 

- the  messages  are  not  printei 

The  names  may  appear  in  the  rows  and  columns  in  the  order  in 
which  they  are  encountered  during  the  processing,  alphabetically 
within  object  type,  or  in  the  order  encountered  within  object 
type.  The  parameters  tor  this  option  are: 

3)  CFPZF-  {DYTYFF- ALPHA) 

{BYTYTE  } 

CNOBYTYPS  } 

The  BYTYPE- A 1 PH  A option  specifies  the  names  in  the  rows  and  the 
columns  are  sorted  by  object  type  and  alphabetically  withir. 
type.  The  RYTYPE  option  is  similar  but  the  names  within  each 
type  appear  in  the  order  encountered  durinq  processinq.  The 
order  of  the  object  types  are  CONDITIONS,  EVENTS,  INPUTS, 
PROCESSES.  The  NOBYTYPE  option  specifies  the  names  in  the  rows 
and  the  columns  will  bo  in  the  order  encountered  during 
processing. 

The  UTILIZES  relationship  between  FFOCiSSES  may  appear  in  the 
report  matrix.  Th-  parameters  to  effect  this  are: 

4)  UTILIZES  - the  UTILIZES  relationship  will  be 

included  in  the  matrix 

N0UTILI7.ES 

- the  UTILIZES  relationship  will  not 
be  included  in  the  matrix. 

The  number  of  dynamic  connections  to  be  traced,  starting  at  the 
given  name,  may  be  set  a*  any  positive  value  via  the  LINKS 
parameter.  For  example,  L I N K F = 2 indicates  that  the  length  of 
any  dynamic  relationship  chains  will  be  two  relationships  from 
the  root  name.  The  same  LINKS  value  is  used  for  all  names  input 
when  the  file  parameter  is  used. 

Analyses 

Each  name  giwn  as  input  is  first  checked  to  see  that  it  is  in 
the  data  base  .and  that  it  is  either  a PROCESS , EVENT,  CONDITION 
or  INPUT  name.  If  it.  is  not  in  the  data  base  the  message 
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UF A370: MAINDA:  NAME  NOT  IN  TATA  RASE  - 

is  printed.  If  the  ob-ject  type  is  not  valid,  the  message 

IIPA371 : KAINDA:  INVALID  NAME  ?YPr- 

is  printed  AND  THE  LAKE  IS  NOT  INCLUDED  IN  7 HE  MATRIX. 

For  each  valid  input  name,  all  ohiects  related  by  the  dynamic 
relationships  listed  in  TABLE  1 arc  retrievel  from  the  aata 
base.  Each  name  retrieved  is  placed  in  a column  of  the  matrix 
and  the  apDropriate  coie  is  placed  a*  the  intersection  of  the 
input  name  and  the  retrieved  name  to  identify  the  relationship. 
If  the  relationship  is  conditional  (DEPENDING  ON)  or  repetitive 
(FOR  FACH)  then  the  proper  suffix  effecting  this  is  also  placed 
at  the  intersection.  Each  retrieved  name  will  subsequently  be 
placed  in  a row  of  the  matrix  and  *he  analysis  is  repeated  for 
each  such  name.  No  names  are  duplicated  in  the  rows  and  columns 
of  the  matrix. 

When  the  matrix  is  complete,  it  is  analyzed  for  conditions  which 
denote  possible  completeness  and  consistencies.  Diagnostic 
messaqes  are  printed  if  those  conditions  exist.  These 
diagnostic  messages  are  presented  below  categorized  by  the  name 
type  to  which  they  apply. 

1)  PROCESS 

- not  TRIGGERED  OR  UTILIZED  BY  another  PFOCESS,  EVENT, 
INPUT,  or  CONDITION 


- not  TFIGGLFFD  BY  another  PFOCESS,  EVEN  1 , INPUT,  or 
CONDITION 

If  no  process,  event,  or  condition  names  TFIGGERS  or 
UTILIZES  (if  the  UTILIZES  parameter  is  in  effect)  the  aiven 
process,  this  diagnostic  is  printed.  If  at  least  one  name 
TFIGGEFS  OF  UTILIZES  the  process  then  the  messaqe  is  r.ot 
printed . 

- does  no  further  processing 

If  the  given  PFOCESS  does  no*-  initiate  any  further 
processing  or  sequence  of  everts  then  this  diagnostic  is 
printed.  It  the  given  PROCESS  TRIGGERS,  TEP El  NATES  or 
INTERRUPTS  another  PROCESS,  or  INCEPTION-CAUSES  or 
TERMINATION- CAUSES  an  EVENT,  or  MAKES  a CONDITION  TRUE  oi 
FALSF,  then  this  message  is  not  printed. 

2)  EVENT 


- Joes  not  initiate  further  action 

If  the  given  EVENT  does  not  TRIGGER,  INTFFFUPT,  or 
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TFFMINAmE  another  PFGCFSS,  does  not  CAUSE  another  EVENT, 
and  does  not  make  i CONDITION  ’’’RUE  or  FA1.SF,  then  this 
diaqnostic  is  printed. 


’)  CONDITICN 

- does  not  initiate  any  action  on  state  change 

If  there  are  no  BECOMING  clauses  for  a CONDITION,  this 
diagnostic  is  printed. 


Two  obiects  that  directly  participate  in  two  different 
dynamic  re  la tionsh i os  with  each  other  ate  highlighted 
because  they  are  potentially  inconsistent.  An  example  ot 
dynamically  inconsistent  UPL  statements  follow: 

PROCESS  PI; 

INCEPTION* CAUSES  FI  ; 

TRIGGERS  P2; 

EVENT  El; 

TF.  IGGEFS  PI; 

PROCFSS  P2; 

TPrGGEFS  Pi; 


Usage 

This  report  presents  the  behavior  of  the  systtm  over  time,  that 
is,  the  sequences  of  events  and  activities  that  comprise  the 
system  and  its  constituent  parts.  The  analyst  may  use  this 
report  *o  verity  the  propel  sequencing  of  events  and  activities 
(processes)  of  the  system,  and  that  the  state  of  conditions  is 
correct  and  that  state  changes  occur  at  the  desired  time.  The 
diagnostics  on  the  report  aid  the  analyst  in  determining  the 
completeness  of  the  dynamics  aspect  ot  the  system  description 
and  correcting  any  inconsistencies  discovered  in  the  matrix. 
These  messages  do  not  necessarily  indicate  that  something  is 
wrong,  but  they  highlight  situations  that  could  be  potential 
problems.  The  analyst  must  determine  whether  these  conditions 
are  indeed  errors  for  the  particular  system. 

This  report  is  related  to  the  PROCESS  CHAIN  report.  The  PROCESS 
CHAIN  report  pictorially  depicts  the  dynamics  relationships 
between  PROCESSES  and  EVENTS.  The  DYNAMICS  ANALYSIS  report 
displays  the  same  relationships  in  the  form  of  a matrix,  and 
additionally  includes  CONDITION  and  INPUT  objects  and, 
optionally,  the  UTILIZES  relationship.  The  sequences  of  EVFNTS 
and  PROCESSES  are  mor*>  apparent  in  the  PFOCESS  CHAIN  report, 
however,  the  DYNAMICS  ANALYSIS  FATFIX  is  more  concise  and 
presents  an  analysis  of  ‘■he  relationships. 


Examples 
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Piqure  28  represents  the  DYNAMICS  ANALYSIS  H7F0FT  generated  for 
all  PROCESS , EVENT,  CONDITION,  and  INPUT  names  defined  for  a 
particular  target  system  description.  This  example  was  produced 
using  the  analyzer  commands: 

NAME-GEN  S = "INTUT  OR  PFOCFSS  pr,  p v F N T CR  CONDITION" 
DYNAMIC-ANALYSIS 

> 

Figure  30  represents  the  DYNAMICS  ANALYSIS  REPORT  produced  for  a 
single  EVENT  name  supplied  as  input.  This  example  resulted  from 
the  command : 

DYNAMIC-ANALYSIS  N =hou r 1 y- em n- processi ng- i n i t 


Part  III  UP  A Outputs 


PM 


I"! 


A A 
O O 


iss 


ul 


10 

0 

*< 

cu 

x> 

iA 

• • 

10 

e ' 

Oi 

• • 

>4 

CM 

M 

*• 

V* 

.Tl 

II 

tn 

r- 

U- 

10 

10 

>: 

*T< 

O 

*< 

r- 

rV 

u 

% 

S. 

V4> 

T— 

l.t 

r* 

O 

r-l 

a- 

r— 

O 

i'l 

II 

U 

in 

IO 

u 

O 

O 

. -1 

4J 

M* 

* * 

.4 

U) 

u 

>- 

O 

</) 

V) 

rH 

u 

U, 

to 

0) 

rH 

u 

C» 

M 

a 

<T3 

0 

n. 

* 4 

U 

0 

>4 

£ 

H 

• 

!\ 

•0 

► 4 

O 

0 i 

t H 

H 

*J  O 

1 

Cl 

r> 

u> 

O 

rH 

10 

>•* 

x 

>- 

•r  <p 

.*1 

pH 

U) 

4* 

TJ 

a>  -0 

r» 

TS 

1 

0 

H 

• 0 

C 

in 

T5 

O; 

ft  ♦ 

•t 

>• 

rH 

a 

X.  to 

u« 

►4 

r-4 

♦ 

fa  fl 

u 

«c 

It* 

S'  rH 

•H 

Vi 

H 

l. 

fa 

Pul*. 

w 

W 

•TJ 

1 

vs 

u 

a>  .c 

c 

CO 

rH 

u ^ 

>. 

-J 

04 

Ul 

T3 

*4 

1 4 

♦-> 

O 

to 

0 

X H 

• c 

0> 

■v 

•H 

Vi 

A 

•r-* 

IH  O 

>- 

<T? 

♦ » A 

n 

G 

O 

n <n 
n 0 

s: 

*'  • 

0- 

ft  4 

3 U 

•5 

d>  x 

t?« 

a*  a> 

♦J 

c 0 

i ♦ 

G x: 

♦->  ti 

•X 

•H 

»H 

a 

*— 

»H 

IU 

1 

O O 

<t< 

0 0 

O 

<11  *J 

*-> 

• 

1 1 

> 

-a' 

0 

O' 

to 

•H  T? 

u 

n »-i 

>* 

cr* 

r a' 

Vi 

► 4 

4.» 

vs  c 

O 

*< 

•U  Tl 

Ul 

rH  r* 

M 

•< 

s 

a> 

O *r4 

<n 

< 

R • 

U Ul 

u« 

1 

U 

VI 

•0 

M 

• • 

•J 

a» 

r:  o' 

T*  V 

> 

U4 

»-« 

u s 

R 

t. 

l#» 

c> 

ttl  *”4 

0)  14 

.*» 

*< 

:u 

• ». 

r-4 

a a 

r 

a; 

Vi 

10  rt? 

ri 

10  xi 

• t 

£-** 

in 

>• 

» O 

rH  > 

> B 

W 

K, 

O 

O ^ 

O O 

O vs 

Ul 

U E 

O U 

M t: 

3 

1 « 

t*l 

T3 

O 

Ul 

r-1 

0)  c 

0 a 

O'  a> 

n« 

X2 

M 

45  V. 

45  x; 

x:  x: 

•< 

M — 

r<  x» 

»ri 

< 

t < t< 


M 

tH 

H 

M 

H H 

f-4 

t->  H 

t-4 

H M 

1-4 

f4 

1 4 

H 

|H 

f4 

1 4 

♦ 4 

t_4 

SB 

W 

SB  XI 

X SB 

SB 

SB 

ca  /. 

z 

as 

SB 

X 

X 

•B 

V*. 

B 

/, 

X 

SB 

W 

CO 

U) 

ui  m 

:a 

tu  (4 

m 

tvi 

Ul  Ul 

Ul 

ui 

Ul 

O 

Ul 

Ul 

M 

Ul 

U| 

O 

O 

> 

> 

> > 

> 

i»  » 

> 

>» 

^ > 

>• 

> 

> 

> 

> 

> 

> 

O 

u 

•1 

O 

31 

Ul  0 

Ul 

>4  4 

0 

>1 

Ul  >1 

Ul 

<1 

4 

*1 

:»l 

u 

si 

>1 

*1 

a 

u 

44 

a 

D 

*>  ■*■> 

x> 

•H 

M 

fa 

T3 

•H  -H 

•»H 

♦4 

C 

01 

it 

a> 

c a 

•»H 

44 

•H 

x 

n 

44 

0 

0 

•H 

•*H 

•H 

a 

H 

Ul 

1 

4> 

0 

1 • 

1 

•H 

u 

G 

U 

a> 

•5 

1 

u 

^ a 

1 

H 

O 

•H 

u 

O 

-TN 

Op 

a 0 

O 

T* 

1 

H 

a 

a 

H 

c 

1 

♦J 

•H 

H -H 

•H 

c 

tTN 

u> 

c 

G 

44 

H 

<v 

44 

H 

•»H 

a 

U)  W 

U 

pH 

a 

OS 

0 

O 

■0 

M 

* 

X2 

Ul 

a 

C 

a 

•H 

U)  « 

IP 

V) 

•H 

O 

•pH 

H 

O 

U> 

•H 

to 

J* 

01 

*H 

•H 

1 

41  O 

O 

Ul 

V) 

43 

44 

•H 

0 

ts 

•<H 

0 

45 

1 

1 

cr 

O -H 

•H 

ov 

V) 

0-1 

If 

<CJ 

04 

u 

cr 

H 

0 

u 

a.  cl 

c 

O )L4 

OH 

0 

O' 

•H 

O 

O 

•H 

0 

G 

t 

'T* 

■H 

X. 

A 

B 

*H 

U f-l 

•H 

c 

O HJ 

U 

•p4 

•pH 

U| 

a 

u 

-H 

-H 

*4 

<tJ 

SH 

0 

<tJ 

O 

O J8 

*4 

a.  u 

U 

Ul 

O *»H 

0) 

OH 

UH 

0> 

u 

tv 

Ul 

C 

•#•» 

a> 

1 

1 

CL  U 

O O 

to 

1 O 

01 

O. 

U G 

> 

•pH 

•»H 

v 

0‘ 

a 

10 

11 

*r* 

u 

V 

u 

1 

1 

1 <U 

•H 

0 > 

► 

1 

CX  *r4 

a 

U 

It 

a 

44 

fa 

H 

O 

•*? 

1 

0 

>« 

Ul  J3 

rH 

O 1 

1 

c 

1 1 

01 

0> 

0> 

o> 

a 

r 

A 

*4 

r* 

Ul 

<tJ 

u 

rH 

<TJ 

U O 

1 

>*  e 

a 

0 

cx  a> 

a 

> 

> 

a 

cr 

• H 

a 

a 

1 

TS 

T? 

u 

U 

CX 

3 1 

T3 

O L» 

u 

■pH 

a c 

•H 

a 

a 

pH 

c 

a 

"O 

X' 

U 

Up 

a* 

f 

O ^ 

U 

r-4  O 

O 

0>  pH 

4-> 

0* 

O’ 

44 

H 

a» 

u 

U 

W 

TJ 

3 

1 

O 

VI 

M *J 

<tJ 

a.  tM 

0H 

(0 

a x» 

a 

a 

a 

1 

44 

Ul 

it 

-0 

«V? 

O 

1 

T< 

-C 

Ul 

1 -t 

O 

B | 

a 

c 

*< 

rH 

•pH 

• H 

rH 

Tl 

u 

O 

U 

t' 

1 

VI 

W 

1 

O r-4  Tl 

I 

ill  aa 

•H 

rH  U 

<0 

4-> 

<t) 

H 

a 

a 

a 

1 

2> 

U4 

Ul 

V 

u 

<Tl  ’H 

<1» 

1 ■ 

a 

a 

u a 

rs 

a 

a 

D 

a 

n 

o» 

O' 

4 

ff 

rs 

m 

•pH 

O'  4-»  rH 

■ 

> 01 

o> 

u 

n X2 

x> 

TJ 

*4 

XI 

a 

a 

e 

•rH 

O 

TJ 

c 

1 

O TJ 

*H 

01  1 

1 

0» 

0 O 

O 

4 ' 

f 

0 

t? 

-H 

H 

♦ ' 

x 

O. 

•H 

X 

4J  > 

4-> 

C rC 

VI 

-c  0 

<ti 

to 

Ul 

•r-N 

44 

44 

4* 

r- 

4 H 

in 

x>  r- 

CO 

<Xn 

T— 

4>4 

ul 

m 

vO 

r- 

O) 

O' 

r— 

r>j 

r* 

r- 

r— 

T-  T— 

r- 

f" 

r- 

f— 

r— 

.M 

<NI 

>1 

>1 

V, 

Vi 

Vi 

Vi 

Vi 

vr. 

a 

c* 

0 

0 

0 

0 

0 

t-S 

►H 

» 

► i 

»-  1 

u 1 

IH 

l-l 

k-4 

. * 

tH 

1* 

l* 

1 ■* 

M 

M 

M 

M 

M 

M 

H 

l * 

k 4 

1 ■ 

1 4 

t - K 

1 1 

I » 

y 4 

1 4 

1 • 

l • 

1 • 

1 < 

n 

O 

r> 

d 

0 

0 

n 

Vi 

B 

V 

Vi 

Vi 

Vi  Vi 

V*. 

V*. 

Vi 

pi 

vr. 

„i 

£«* 

Vi 

Vi 

Vi 

Vi 

SB 

W 

Vi 

U4 

Ul 

Ml 

MM 

M 

HI  10 

10 

Ul 

ro 

hi 

M 

Ul 

.0 

nJ 

0 

0 

0 0 

0 

0 

0 

> 

> 

?» 

> 

> 

> > 

> 

> 

> 

> 

> 

> 

> 

> 

> 

u 

u 

CJ 

0 

u 

0 

u 

iftl 

•1 

.'1 

»l 

•j 

10  .0 

lw| 

10 

41 

10 

i>| 

;*i 

hi 

•s| 

0 

Ul 

U4 

a 

4»  *> 

•rH 

Ul 

Tl 

'•H 

•H  *H 

•rl 

u' 

G 

a 

c 

J 

G G 

» , 

H 

44 

4> 

G 

•H 

U* 

3 

a’ 

0 

•pH  *pH 

•rl 

;V 

•rl 

pH 

14 

a 

1 

0 

c> 

0 

1 1 

1 

•r4 

G 

G 

O' 

G 

G 

Ul 

>t 

Ul 

r*s  u 

G 

a 

■r| 

pH 

44 

0 

0 

1 

0 

0) 

cx 

a 0 

0 

c*  *J 

a 

a 

a 

H 

•H 

vU 

T*' 

rH 

a 

a 

♦4 

4 * 

*H  *pH 

•pH 

c 

•*H 

cr 

G 

G 

44 

U> 

a- 

a> 

U. 

r*-. 

M 

•pH 

•pH 

to  *•' 

4* 

•pH 

G 

G 

0 

0 

T* 

,G 

0 

to 

0 

u 

G 

10  <v» 

<ts 

to 

••H 

•*H 

•pH 

H 

0 

u 

0 

tn 

Oi 

rH 

3* 

«' 

•H 

•pH 

41  u 

u 

n 

1 

I" 

U4 

44 

•H 

•H 

H 

T? 

•H 

• 

Ufc< 

u 

-C 

1 

1 

O -H 

•H 

HI 

r> 

10 

<C* 

<r 

44 

44 

a. 

pH 

>. 

tl 

a 

<P 

u 

CX 

CL 

O 'Ll 

04 

u 

G 

O 

i' 

0 

•rl 

a 

rH 

TS 

•H 

0 

a 

-C 

>- 

R 

a 

14  »pH 

•»H 

0 

•»H 

O D 

•H 

pH 

14 

U 

0) 

«t? 

Ul 

fTt 

M 

1 

u 

Its 

0 

c 

CL  tl 

U 

u 

♦J 

O 

•H 

Nftl 

44 

V 

a> 

i > <v  i ui  u | Q.0UO1  i>  a>  cl  in  u a —t  -h  > > 

U | U # ? 'J  O U | | I 01  91  > > I a.'H  II  LI  I | 

o t?  1 *■'  o u 'w  o ►*  ><  to  c a<  1 • c • | i>  a>  a>  41 

w 'H  n * W « 1 Ur-(<PUO>-HPO|  fi.  t"  > > « B 

| | 'V  "TJ  • u Tl  14  U a 5 | O U U H TJ  H C • | H ,4 

it)  4'  44  i M | Ll  4 3 | O O O *)  44  41  t4  Ji  j *J  *J 

*’  ai  1?  3 o 4 nf  1 o ti  x f a '*4  44  iti  ■()  1 <->  m r 1 1 

It)  >•  O | U B l>  Tt  -C  W I T-(  n • • e O X « 1-4  r-4 

Tl  O | to  Ul  •«-»  I 01  t O H H3  J|  a O'H  | H 14  *)  *■'  HI  It! 

• -I  fli  u a>  ♦>  o w *J  u «« -H  1 nneoui  i i nr 

in  u.t  3 1 I Bl/iTtn^i-ij  jid'uB  r4iirTi»'t4 

^B.HOOO-HTICJ  O Ifl  o 1 | VHOO*-*’Ot' 

1(1  tl  *4  .8  C S *)  a*4i  *1  > e MJ3  4I4*  fl‘n«  H tM) 

f <n  >*r*  J irt  vp  t—  od  tTs  »•»  ^ ,n  <o  rt  in  *p  t—  cr  <t>  o t-  in  <n 

v-r-r-t— r-T— r— r-v— T—  rNC^j  "NJ  '^s) 


189 


I/O 


W 

O 


cl 


in 

Vj 

Oi 

to 

</l 

O') 

t/i 

mj 

01 

t/> 

in 

L0 

V) 

LO 

in 

if) 

0) 

in 

O) 

0) 

O) 

Ol 

Ol 

l/> 

O) 

0) 

VI 

0) 

0) 

O) 

0) 

0) 

if) 

Oi 

m 

i/i 

</) 

O) 

va 

0) 

01 

t/i 

in 

ui 

f«0 

01 

LO 

Ol 

V) 

in 

01 

V) 

01 

V) 

in 

Uj 

O) 

Ol 

V) 

O) 

O) 

01 

01 

o, 

H 

r-t 

JO 

ftj 

•i 

l«, 

iO 

CO 

(O 

to 

Ul 

to 

M 

to 

r*i 

to 

U4 

to 

10 

CO 

to 

jU 

iq 

CO 

ro 

.0 

to 

CO 

w 

CO 

►o 

CO 

to 

to 

>* 

A 

u 

L) 

u 

U 

u 

u 

u 

o 

u 

u 

O 

u 

a 

u 

f ) 

u 

u 

u 

u 

u 

G> 

u 

u 

U 

u 

u 

L) 

u 

u 

u 

u 

u 

W 

ui 

o 

O 

o 

a 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

a 

o 

o 

o 

o 

o 

o 

o 

O 

o 

n 

o 

o 

3 

> 

> 

»« 

U4 

A 

lU 

A 

IX, 

iq 

u* 

U4 

a; 

A 

u« 

iO 

CO 

IX, 

Ul 

U5 

»L 

iO 

in* 

Ul 

»o 

UL, 

16 

uc, 

Ul 

16 

it. 

j, 

•q 

»*4 

M 

•1 

*q 

04 

cl 

a. 

‘"Vl 

cl 

cl 

a. 

cl 

a. 

cl 

& 

CL 

cl 

CL 

cl 

Ol 

Ol 

Oi 

Ol 

CL 

Ol 

cl 

Cl 

ru 

Ol 

Hi 

a. 

Oi 

Oi 

CL 

Ol 

ru 

>> 

'O 


a 

o 

G H 


G 3* 


o> 


£7»  H 


3 

O 

G 

u> 

O 

c 

G 

to 

G 

0) 

G 

G 

•H 

u 

(C 

rH 

•H 

•rH 

to 

G 

c 

O 

4-» 

to 

H 

G 

3 

o 

G 

G 

4-> 

A 

O' 

cyi 

A 

HJ 

O 

o 

rH 

<TJ 

0) 

1 

G 

u 

T? 

3 

o 

O 

■TJ 

to 

G 

c: 

to 

u 

•rH 

•rH 

4-> 

T3 

U 

0) 

O 

X) 

u 

H 

3 

O 

CL 

H 

•H 

rO 

OJ 

rH 

H 

u 

o 

G 

4-» 

G 

Oi 

- <TJ 

4-» 

O 

in 

d 

1 

T5 

G 

a 

O 

O 

H 

U 

to 

W 

o 

O 

«X3 

<TJ 

Ul 

3 

3 

<TJ 

G 

U4 

G 

i • 

•H 

Cr 

O 

CL 

W 

o 

it* 

r— 1 

o 

Li 

W 

o 

CL 

•H 

U 

rH 

a> 

• 

O 

o 

CL 

O 

o 

cr 

m 

4' 

c 

Li 

1 

o 

o 

♦J 

f 0 

Ul 

a» 

a- 

Ul 

1 

4-» 

•H 

3 

c 

10 

3 

CL 

• rH 

1 

•H 

o 

c 

g 

1 

•H 

CL.  M 

•H 

i 

3 

3 

> 

CL 

u 

u 

CL 

a» 

(C 

4-i 

u 

OJ 

<u 

c 

1 

3 

Ul 

4 

Ul 

•rH 

• • 

tl 

4J 

1 

o 

*-> 

to 

a 

CL 

1 

1 

o 

o 

• 

a> 

O 

•H 

rH 

4J 

rr 

OJ 

0‘ 

O 

10 

1 

O 

u 

CL 

4 > 

<N 

o 

to 

.X 

a' 

tJ 

G 

c 

m 

P 

G 

a> 

Ul 

u 

CL 

>s 

•H 

Ul 

rr« 

IT 

• 

4-> 

•rH 

Cl 

LO 

iri 

t4 

4> 

<v 

1 

*0 

4-1 

*H 

u 

.c 

4J 

o 

o 

o 

O 

o 

a> 

CL 

a. 

a 

o 

4-1 

<u 

0 

»r* 

>- 

<C 

<T? 

o 

G 

•H 

Ul 

•rH 

Ul 

Ul 

•rH 

1 

»-H 

o 

a 

3 

•H 

•H 

o 

o 

•H 

1 

i 

<l) 

rH 

•H 

> 

1 

a. 

Ul 

T) 

T? 

o 

•H 

O 

rH 

a» 

14 

O 

rH 

Ol 

G 

1 

JCZ 

a. 

4-» 

•u* 

1 

1 

4-» 

o 

e 

d' 

i 

CL 

Ul 

i 

a 

3 

0/ 

H 

CL 

CL 

G 

4-> 

•rH 

0) 

0? 

i 

3 

o 

Ul 

1 

r 

to 

C 

u 

<T3 

e 

o 

>« 

to 

<TJ 

H 

j 

01 

rr 

S 

<i> 

3 

• 

4H 

C 

D 

3 

T? 

U 

4-» 

4i 

> 

V 

o 

Ul 

G 

r* 

*: 

OJ 

O 

>• 

CL 

o 

•U> 

3 

<TJ 

Ul 

X-» 

CL 

•H 

>> 

c 

a; 

> 

a cr-H 

CL 

C3 

a 

1 

1 

(V 

3 

o 

<T? 

1 

R 

1 

• 

a 

o 

O' 

•< 

3 

•H 

(0 

1 

o 

3 

TJ 

CL 

3 

3 

B 

R 

o 

•rH 

i 

1 

•rH  c a 

e 

T3 

i 

a. 

TT 

'O 

3 

'O 

'a 

•H 

"3 

T5 

i 

•r4 

i* 

cr 

G 

O.TJ 

1 

CL 

. 0^ 

1 

o 

CL 

1) 

a 

r-H 

4-> 

y 

y H 0/ 

Of 

a. 

4-> 

B 

1 

0J 

CL 

Ul 

4-» 

U 

u 

c» 

*-» 

a? 

o 

1 

0) 

>. 

& 

T? 

to 

s: 

E: 

1 

Ui 

CL 

<0 

a> 

R 

| 4-*  Ul 

i 

3 

Ul 

a> 

CL 

rH 

T? 

D 

• 

r 

a; 

t= 

5J 

% 

sc 

u 

(C 

•H 

O 

1 

n 

i 

o 

>> 

CL 

F 

c 

• H 

•H 

rH  IT?  CL 

>- 

1 

o 

i 

1 

<T« 

1 

'O 

1 

o 

rH 

o 

O 

•H 

sO 

*: 

i 

to 

H 

U| 

Ol 

O 

H 

o 

rH 

o 

H 

• 

Or 

rH 

M 

4-> 

f0  Ul  | 

r-H 

to 

CL 

to 

to 

Ul 

a 

1 

(0 

• 

1 0 

1 

• 

•4- 

r- 

13 

g 

c 

Ul 

TJ 

1 

1 

Ul 

•X? 

1 

Ul 

a 

1 

Fs 

1 

3 ♦ 

> 0) 

t-4 

k-i 

O' 

14 

w 

•V 

4-* 

<r 

*c 

0i 

3 

u> 

<y 

1 

c 

-i 

rH 

<n 

3 

H 

H 

4-» 

3 

O' 

Jt 

Ui 

r-H 

>— i 

4-»  x:  rr 

•J 

3 

tJ 

3 

o 

'T- 

1 0 

o 

G 

6 

G 

R 

*3 

tts 

Qi 

o 

c 

u 

o 

0; 

as 

o 

I 

O 

(T3 

o 

(C 

a‘ 

a> 

«T? 

0 O <rj 

o 

o 

f 

O 

Ul 

V 

4 

•H 

3 

•rH 

o 

•rl 

•rH 

4-> 

LI 

IO 

t n 

tj 

G 

xi 

to 

G 

4-> 

JZ 

L> 

a.  jc 

* 

G 

o 

to 

to 

It3  ‘f  ' i 

x: 

x: 

x: 

L 

4-J 

4H 

41 

4-» 

(T? 

4 

4-1 

to 

H 

U J 

O 

Ol 

*u 

r^ 

r> 

o\ 

c* 

T~ 

rvj 

m 

3 

LO 

*u 

r- 

TO 

O* 

• J*  f—  *H 

3 

O' 

■o 

r- 

T 

Tv 

3 

O 

f*> 

If* 

o 

r- 

< 1 

'M 

« >1 

fN 

M 

*o 

• n 

M 

• • i 

m 

• A 

• A 

3 r o 

-j 

rr 

-j 

3 

3 

3 

rr 

m 

• o 

Ul 

Ul 

lO 

lA 

«o 

m 

O' 

CM 

I 

M) 

U« 

13 

t? 

► l 


o 

ll 

a> 

u. 


to 

>* 


.o 

c 


o 


•rH 

O) 

o 

rr; 

Vi 

U) 

in 

in 

t ) 

c/i 

c. 

l) 

B 

V 4 

01 

L/.' 

i't 

O'i 

V) 

t. 

0) 

C/4 

c 

Mi 

(C 

t*  t « 

t-* 

H 

h ‘ 

M 

( « 

t « 

r i 

fi 

H 

l < 

M 

H t » 

b « 

t-4 

l * 

i < 

i * 

M 

b i 

t 4 

l • tH 

i « 

Ml 

ul 

r ; 

4*J 

Mt 

1-4 

ii 

U) 

tq 

U*. 

C 

cs  VC 

A 

W 

cr. 

A 

s& 

Si 

Si 

Si 

A ic 

•t 

Si 

ss 

S'. 

13 

cz 

13 

13  U 

ri 

U 

u 

-j 

t.i 

U 

U 

u 

u 

U 

U 

o 

>* 

U)  »g 

l<( 

1*1 

l«1 

t>l 

M 

I«1 

ivj 

III 

Ul 

lU  rq 

1*4 

q 

to 

ro 

fL 

fL 

IL 

iL 

LL 

Hi  lL 

iL 

o 

o 

o 

o 

a 

c 

o 

o 

a 

o 

— r 

Cl 

s>  >• 

>• 

>• 

> 

>• 

> 

> 

> 

>• 

S> 

> 

s» 

>•  >• 

>• 

s» 

> 

> 

Si 

V - 

Si 

VS 

si  sx 

Vi 

*L 

»L 

*L 

i). 

i*-, 

i; 

u. 

•x* 

»»4 

04 

.1, 

>•  J 1 

M 

•1 

*tj 

*1 

*i 

Ul 

*1 

*1 

•*)  * 4 

.<1 

Ul 

q 

i 

* 1 

» 1 

1 1 

t H 

i 4 

mm 

i < 

r.. 

1L 

a. 

n* 

l -4 

ix« 

n« 

LL 

iL 

IL 

X 

a 

44 

Cl 

Ul 

•H 

F 

0* 

o 

O 

a> 

»^i 

c: 

Ul 

G 

•H 

•H 

Li 

rr 

-rH 

4» 

3 

•rH 

O 

<r 

G 

4-* 

o 

u. 

i V 

LI 

1 

G 

1 

G 

44 

B U 

O 

CS 

rH 

•r  4 

•rH 

0 

!T> 

Ul 

•V  to 

cr 

rH 

1 

U -H 

3 

G 

44 

c: 

G 

to 

ir 

to 

U 

C 

O 

1 

G 

G 

G 

R 

O 44 

3 

O 

o 

o 

*J) 

*-« 

If) 

u 

*— 

•H 

t-4 

o o 

•H 

H 

U 

Ul 

44  rH 

o 

a- 

3 

H 

* » i 

a» 

•rH 

U' 

o 

♦ L 

w 

11 

G 

*H  R 

to 

t-l 

T5 

| 

,4 

C 

• G 

Ui 

R 

* 

44 

u 

to 

u 

Ul 

• O 

to 

V 

•rH 

CL. -4 

o 

0) 

rr 

»4 

4 4 

G U 

CL 

O 

c 

o 

tt 

tt3 

0 

to 

o 

a. 

• 

0i 

1 

c 

a g 

D 

Ul 

G 

c 

•n 

1 

g a 

1 

U 

O 

ui 

G 

G 

Ul 

xi 

Ul 

i 

o 

r* 

44 

•H 

o p 

U 

Ul 

U 

•H 

G 

4- 

u»  u 

Jr 

1 

•H 

u 

3 

3 

CL  (J 

UL 

0J 

o 

C 

•rl 

1 

U Ul 

O 

a 

a> 

4J 

•rH 

iZ 

to 

r i 

O 

to 

4! 

• 

a. 

C. 

t 

o 

1 

•j* 

SI 

B Ui 

•H  n3 

U 

G 

1 o 

Ul 

i 

H 

to 

B 

a* 

>>  O' 

C 

c; 

G 

(tS 

H 

H 

vU 

u 

UL 

s 

o 

ui  a, 

to 

C 

0) 

•H 

>-4i 

CL  4-1 

rH 

14 

E 

H 

O G 

x; 

o 

O 

4 J 

V 

O 

O 

4* 

n- 

e 

o 

M 

i 

m 

3 

> 

T? 

^ 1 

i 

•rH 

o 

H 

a> 

> 

CL  rH  *rH 

u 

•H 

•H 

3 

0* 

o 

c 

>> 

l 

a» 

rH 

01 

u>  e 

•rH 

O 

1 

3 

G G 

CL  14 

o 

1 

G 

Cl 

c: 

a.  xj 

>,  G 

4 

LL 

x: 

1 

i! 

o 

c* 

• 

a. 

U< 

1 3 

e 

4-1 

01 

(3 

G 

o 

G (0 

& 

a* 

3 

G 

1 

rH 

•»H 

B -H 

<T? 

o 

rC 

fi 

u 

>*  10 

r-4 

a> 

tT 

5 

M 

cr  *h 

i 

1 

H 

1 

0) 

Ul 

a» 

0) 

C'  O 

O' 

> 

to 

o 

G 

Ur 

1 

<*J  o 

a. 

3 

4-' 

O 

>* 

<TJ 

14 

CL 

>- 

cz 

<r 

=> 

O) 

c F 

T? 

•rl 

TJ 

> 

3 

o 

> 

X 

Ul 

O 

1 3 

1 

i 

T3 

rH 

f! 

e 

R 

1 G 

I 

*T5 

3 

u 

O. 

H 

R 

o 

i 

It) 

•H  Or 

Ul 

1 4 

G 

U 

•rH 

O 

G 

o 

H 

G CP  TT 

a 

Ul 

G 

a* 

vU 

X 

c 

T7  .ij 

LI 

to 

a> 

LL 

s 

a. 

e 

o 

a> 

»-H 

4 4 

t: 

G Ul 

nJ 

ifl 

1 

it? 

4-1 

4-| 

O 

to 

to 

u» 

G 

U 0! 

a 

E 

rj 

0 

E 

k 

•rl 

*' 

a>  n 

*T3 

V 

*3 

B 

a 

to 

X‘ 

i 

CL 

<r 

v 

a. 

• c 

i Tj  Q« 

O 

U -t 

o 

1 

1 

1 

1 

1 

• 

1 

O U 

•H 

•rl 

U 

9*1 

s 

>> 

to 

G 

to 

■rt  H 

U 

rH 

i 

O 

<Tl 

> 

to 

1 

>- 

R 

G 

H 

13 

«G 

M 1 

1 

f 

1 

G 

G 

G 

4-‘ 

G 

G 

G 

Q-  l 

<1 

G 

f 

'0 

o 

rH 

1 

1 

>- 

U » 

1 

U| 

r-H 

U 

a,  r-H 

O *-H 

rH 

0) 

•rl 

14 

1 ^ 

a> 

3 

a> 

G 

C 

C 

G 

G 

G 

C 

a< 

It* 

1 

O' 

G 

rH 

tl 

O' 

a? 

i) 

«3  I 

a> 

<r 

1 

l 

(i 

U 

id 

U 

1 

B 

0? 

3 

n rr 

a 

a 

G 

E 

a> 

0) 

o 

O 

O 

a* 

O 

U -.i 

rH 

T3 

n 

it 

CL 

3 

B 

H 

>*  rH  X 

G 

rH 

G 

X 

G 

3 

G 

—1 

.» 

14 

rH 

o 

O <Tt 

•rH 

•rH 

o 

•rH 

> 

> 

> 

> 

> 

> 

> 

l C 

G 

• rH 

Ul 

a 

c 

<T? 

<r 

<TJ 

<r  « 

•H 

o 

re 

0) 

O 

1 

O 

o 

QJ 

a* 

<n 

tt, 

T-  » 

4-> 

4-> 

IT* 

44 

<u 

o 

o 

o 

o 

o 

0) 

A -ri 

to 

to 

G 

G 

0) 

x: 

C 

G 

Q.  l/l  •’ 

G 

to 

G 

4’ 

G 

c 

C 

G 

xi 

c 

G 

to 

•#  in  'o  r- 

00 

ty\  r> 

m 

31 

in  lo 

r-  no 

O' 

3 

r-“ 

CM 

r*> 

■t 

in 

•G 

r- 

oo  cr 

3 

r* 

m 

rn 

-r 

m 

VO 

ct> 

o 

(N  <N 

rs|010|  Ol  n 

rn 

rn 

rn  rn 

ro  m n 

m 

3 

31 

cr 

cr 

cr 

cr 

cr  -r 

in 

in 

m 

in 

m ir 

m 

m 

in 

in 

vO 

'O 

in  ut  in  in  in  in  u>  <n  in  in  o>  cn  in  in  t/i  in  <n  in  in  w in  in  in  in  in  in  c/j  in  in  in  in  co  in  in  in  in  in  cn 
uj  uj  i/i  u>  uj  tyi  (7i  in  ut  (ii  (7i  c/i  Uj  m uj  ui  uj  ui  uj  ui  ui  in  cn  in  uj  ui  ui  ui  uj  cn  in  uj  In  uj  Ui  uj  Ui 


tl4  IX*  it*  Mi  H*  Mi  Hi 
Ui  Ul  Dl  Ul  & Ul  Ui 


1(4  Ui  Ul  IO  Mi  |i<  U4  l<4  ^ U4  U<  Ui  « Hi  |4  »(«  M (li  Ui  ^ 1(4  U4  U4  Ul  Ui  (L 


c u 
O O C 


CJ 

o u c 
•H  O O 

4->  H 


o 

U 

o; 

4-» 

•ri  *ri  O 

U rd 

a)  v 

p 

c 

c 

•iH 

o 

4-> 

a 

rd 

Pti-i 

O 0)  ft  (0 

IP 

O' 

o 

o 

♦J 

•H 

Oi 

id 

o «-* 

U 

(0  0)  P 

C 

•H  U 

0J  'O 

Ul 

a 

•H 

■H 

rd 

4-' 

a; 

4-» 

nd 

u 

•ri  10 

Or 

0 ) ri  t) 

O 

p U '3  -H 

O' 

t— 

•H  G 

4-> 

4M 

•a 

id 

u 

rd 

Qu 

o 

P > 

a 

tT1  M 0-  T3 

•H 

<0  | 

1 H 

G 

IX* 

m o 

rd 

<d 

•H 

u 

id 

'V 

3 

c 

M 

c 

•ri  O 

0) 

e U 'O  -ri 

Ul  c 

C >0 

0) 

r+> 

Ul  -ri 

U 

rH 

rH 

cu 

ra 

a* 

1 

o 

a. 

o 

U 

Cr-3  B 

IT 

•ri  | | r-l 

id 

0)  o>  o 

o > 

O' 

• 

0)  p 

•H 

3 

rd 

c: 

Oi  3 

in 

•H 

i 

•H 

O 

c 

-3  W 

t 

ui  a c f 

CT> 

4-* 

CP-H 

•H  I 

1 

P) 

U (0 

u 

> 

a> 

(V 

SJ 

• 

e 

4-> 

u 

+J 

M 

•H 

(0  u 

>.  Ul  o o > 

c 

3 

0)  (0  p 

P JC 

;p 

o o 

•H 

rH 

1 

O' 

a; 

4J 

t 

<n 

o 

0)  rd 

o 

u 

a.  4-> 

1 1 

u 

0>  "H  -ri  | 

•ri 

O-  CP-T3  IT) 

i0  u 

Ul 

U *ri 

M 

rd 

a 

t 

4-> 

rd 

in 

a 

•H 

4->  T3 

M 

•u 

OJ 

1 

in 

Oi  a> 

p 

U P P » 

Ul  >- 

B 

1 a,  b 

b a> 

p 

u 

O-i  <4-1 

0) 

U 

o 

>- 

rd 

nd 

c: 

o 

rd  -H 

u 

u 

U 

•H 

ft  ft 

a 

O <0  «J  U 

Ul  M 

O 

►.  3 M 

Ut  J3 

c 

1 H 

S 'ri 

> 

t 

•H 

u 

*D 

u« 

O 

•H 

U -O  r-» 

Q1  Tl 

u 

O ft 

•ri  ft 

0) 

M e e 0) 

0>  (0 

V 

M | O 

o u 

0) 

U> 

e u 

t 

B 

«P 

u 

a> 

Di 

3 OJ 

•H 

*-» 

3 

a (0 

i 

3 

o 

M 

1 

4-1  4-1 

1 

a it  u ,c 

U U 

I 

P O-  44 

4i  (p  1 

. t« 

3 01 

a) 

3 

rd 

U 

4-> 

3 

♦-> 

u 

nd 

3 > 

a< 

id 

u 

M 

fc3 

1 1 

p 

1 o o u 

O-4-i  4i  >- 

o .a 

>u 

CSC 

c id 

p 

M 

•ri  t» 

a 

tT-H 

U 

a; 

rd 

o 

3 

<u 

1 1 

a 

l 

1 

(1) 

o 

P P 

u 

M -ri 

a 

0)  0)  -ri 

•H  Ui  M 

> 

i/) 

H 1 

•H 

« b 

3 

i 

T3 

B -T3 

3 

O 

^-.-o 

-o 

1 

•ri 

c r 

o 

H C C it) 

04  ft 

a 

f 1 1 

1 1 

o 

•M 

a«  a. 

4J 

•H  0> 

Ui  *j 

U* 

B 

0)  0,-0 

0) 

1 

10  u 

4-» 

M 

u 

a> 

P 

0>  0' 

a.  o>  -h  *ri  a-ai 

1 1 

l 

P -O  T3  -T3  t3 

Qu 

# C 

23 

Ut  B 

1 

4-»  U 

s 

u 

r* 

<y 

1 3 

a> 

rT3 

rH 

a,  to 

1 

<d 

<0 

B 

U 

a a 

0) 

1 1 t 1 c 

ft  Ul 

Ul 

It  "J  a> 

-i)  0) 

i> 

H* 

r* 

O.  -ri 

rH 

rd  Ui 

o 

o 

r 

i 

►"  1 

1 

id 

1 U r-i 

u 

u 

•ri 

10 

p p 

u 

o 

ft  Ul 

Ul 

O •-*  ri 

ri  ri 

It 

ro 

1 P 

Id 

M | 

u 

Du  Ul 

Ul  ft  UJ 

• 

b 

u 

U)  1 

rd 

i 

1 

■P 

Ul 

u u 

1 

ft  rH  ri  ri  1 

O 01 

o 

a.  ut  u 

Ul  ti 

1 

1»  | 

3 

t *> 

i 

Q> 

u 

u 

U TD 

rd 

0) 

m a> 

3 

a) 

d! 

1 

a 

«o  a 

0) 

M p M U 0) 

u u 

u 

0)  (0  ITS 

IT)  ITS 

B 

r« 

Cr-C 

p -Q  cr 

>S  w 

3 

3 

3 C 

U 

10  -tJ 

O B 

4J 

B 

B 

-o 

(0 

aau 

3 3 3 3 B 

>4  O 

cr 

p ft  ft 

ft  ft 

Ul 

o 

(0  P 

u 

O id 

id 

1 

o 

o 

O 3 

•r| 

ai 

1-4  -H 

u 

•H 

•H 

p 

u 

0)  0) 

•H 

o o o o a 

a u 

1 

1 in  10 

a to 

0) 

» UI 

rd 

•m  » 

a.  js 

JZ 

JZ 

•e  <w 

4-4 

Ul  «-l 

3'i-» 

Id 

4-» 

+> 

Ui 

P Tt  Tt 

iC 

a £ £ ,c  a 

u,  a*  tn 

Ul  Ul  Ul 

Ul  io 

p 

-vi  m 

& 

lO  «o  h 

ao 

C7>  C 

r-  rN  ro 

m 'o  r>  ® 

a> 

fN  rn  ^ 

tn  vo  ao  O'  o 

r-  IN  ro 

3 in  vo 

(p  <T)  tr 

'O  >0 

\Q  'sO  v£) 

vO  <0 

vr>  r- 

cp  |p 

r*  r*  r*  r> 

ao  00  OP 

ao  ao 

oo 

00  rt5  00  00  <T\  <T\  (T 

CT  Cn  0>  Oi 

(TI  (Ti 

<T 

>1 

p-x: 

xi 

T>  fi 
TJ  0> 
iXS  4'  4J 
♦->  ti 


•rl  ill  <>• 

*J  W H 

U .11  O 

u t:  :n 
in  m 

U *r.  *- 
4)  W *.l 
h»  41 
U 'Ll  t' 


c:  n 

■n  A r-l 


il 

(4 

*i> 

H 

u 

0 

H O 

S.1 

*»-4 

M 

O 

O 

a 

in 

O 

n u 

In 

to 

» < *r\ 

n 

ii  c: 

4*1 

vl» 

Cm 

> 

UJ 

4) 

u 

01 

t'l 

rH 

i h 

Hi 

O 

u>  0 

O 

O 

4> 

o 

w 

U 

ih 

O 10 

1X4 

1 * 

U C 

h 

•m 

ti  U 

ii 

C 

\ *, 

I 

u 

il 

n* 

»n 

n. 

1 » 

* • It* 

p 

• < 

H 

r-H 

O 

ai 

1 1 

It  ♦ 

LL 

41 

m 

< 

1*1 

i». 

V« 

to  n 

O 

1: 

c u 

1* 

<0 

U 

trv 

in 

u 

0) 

u 

•m  M 

11. 

•-r. 

to  0 

1*4 

l 4 

1*1  . -4 

O 

e 

a; 

it 

to 

Vv« 

<M 

•rl 

<TJ 

u 

•r-t  *r-t 

•r>  O 

11. 

1 < 

•*4  e* 

M 

> t 

04  O 

r» 

•P  c 

u 

il 

.0 

U]  0 

1 

in 

rH 

41 

u O 

10 

j ; 

to  1 1 

IO 

I4« 

to 

M 

1 ^ 

rH 

U* 

> 

.*) 

>, 

r? 

a* 

a 

•m  c (4 

CRM 

f i 

Hi 

r>  .*4 

■-?; 

• 0 

!M 

•m  O 

*41  *r4 

1 1 

10 

k»4  O 

1*4 

H 

O 

r 

<a 

a e 

h r?  0. 

iO 

*»:  1-4 

1 1 

1 1 

O <0 

O 

4J 

O CV 

• 4 

1 1 

^ — 

3 3 n 3 r-4  i « i 4 
H r(  i— I O | I 


l • U , | 

l | 1*1  1*1 


O O n o u m m i»i  i>i  in  o: 


i i -• 

i i-i  hi 
C IM  X* 


(TJ 

41 

rH 

kJ 

u 

t» 

0 

s^» 

C_' 

r? 

e 

► 1 

► 1 

» A 

4 

►V 

1 

r-4 

A- 

il' 

0 

r„ 

0 

3 

40 

ii. 

0. 

I>4 

M. 

• k 

*v 

*C 

*k 

u 

U". 

c 

0* 

U 

C 

O 

C 

> 

1 

•M 

u 

01 

O) 

r 4 

10 

01 

n 

l • 

l 1 

L • 

it. 

u. 

U, 

i 

u 

O 

fci 

n 

0 

a 

O 

r 4 

13 

ctt 

14 

40 

0 

0 

»“4 

1 

1 

1 

1 

I 

1 

1 

• 

4 4 

<\4 

ii* 

*H 

ii 

fT" 

U 

1 ‘O 

♦-* 

* 4 

X-) 

to 

to 

fc-4 

u 

u* 

0 

Li 

LI 

L3 

6 

15 

0 

1 « 

t/> 

to 

il 

4 

0 

a 

t ; 

1 4 * 

•H 

0 

C 

(TJ 

It* 

< 

4-4 

fv. 

v, 

m *» 

%"l 

« , 

u* 

1 4 

» C 

0 

u 

0 

1-1 

ft 

•»  1 

| *H 

♦ * 

>x 

0 

>1 

H 

1*4 

TT. 

0) 

1 4 

M 

1-4 

1 -4 

1 1 

♦ -4 

• 4 

II 

1 4 

<.  • 

ts) 

'll 

P 

ip 

it 

1 r* 

Vi 

ii 

i3 

<TJ 

tr 

H 

to 

to 

04 

^ 1 

»: 

>: 

1 J 

>: 

•* « 

-•  .* 

.•■I 

•ii 

1 4 

l 4 

.*4 

vi» 

c 

1 *. 

Ll. 

4* 

w-T 

* 

4 

•»J 

•i) 

O 

'•I 

0 

u 

0 

0 

0 

.*> 

0 

• O 

; 

• 1 

41 

.ft 

TH 

O 

•i* 

, 0 

.U 

O 

0 

1.1 

• 4 

4 > 

l«* 

y. 

u 

LJ 

0 

D 

j 

0 

u 

u 

O 

i*. 

1 4 

4‘ 

it* 

.14 

:o 

i 

44. 

•n 

n.  >*.  hi  **- 
t ' i ( l i ( l 


.(  >C  hi  III 

>:  a>  m 


hi  1 1 1 III  hi  III  ;«*,  111. 

m in  oi  in  in  * 1 1 • r» 


■r  l •(  | -fl  -»l  'h  *1  'H  -r|  -»l  'r-l  'll  'll  *1  'll  "1  il  i| 

OOOOOOOOOOOOOOOCOO 

11*  m Mi  m iii  Mi  hi  iii  iii  i*i  mi  ill  tii  hi  Mi  ih  ii  i*i 


"l  o 

Cl*  t*.  •• 


T" 

JwJ 

•>* 

a* 

1 1 

M «* 

<0 

It* 

i»  H O 

• 

4 4 

Ji  i i vl 

m 

•l 

»J  +•  4-1 

>"♦ 

«?  41 

k* 

^ a ih 

O 

to 

<0 

4 4 

4 4 

in 

to 

0) 

H 

*1* 

>« 

•pi  n 

SO 

. J 

. r* 

> 

•k 

H 4J 

U* 

— O i5  • 

rk 

< 

a rl 

l>. 

>.  'P*  3 

ri 

u 

Ul  r-l  » 

4 3 

♦»  r.  0 0 

>. 

c:  non 

*< 

ill  3 

» • 

»■+ 

r-l  a*  <u 

y. 

C O xi  x: 

0 

.<  0 n n 

«<  CQ  l)  O M tl<  l"  Ct5  M »-J  V 


o rii  -y  x 


a* 

»*; 

■V 

in 

r. 

1 .x 

M 

<1’ 

*i* 

it 

P 

p 

M 

t: 

.-4 

rH 

0 

a* 

C 

t') 

IP 

O 

<n 

rM 

i> 

j 

> 

JLX 

u« 

il. 

K 

V 

*•' 

it* 

a 

•H 

X 

.1. 

lit 

«p 

*44 

•r  4 

*‘ 

in 

rt 

U 

4 i 

a* 

w 

r* 

l|  4 

O 

♦ 

O 

t't 

!•> 

IP 

c 

a> 

l 

0 

> 

a» 

14 

rH 

t». 

•rH 

a; 

0 

•t) 

Ip 

»* 

t * 

•»4 

k— 

r: 

. 4 

•H 

♦ ’ 

• 

rH 

11 

V 

c: 

•n 

H 

0 

11. 

♦-» 

T* 

• rH 

il) 

0 

(P 

4X4 

41 

11 

<4-1 

* 

C 

fa 

il 

M 

1 4 

in 

0 

0 

'I—**—!— 


ama 


w 


wmm  "fv.i'v 


mm 


CD 

ifl 


U4 

O 

-c 

04 


n 

m 


m 

o 


rv 


r- 

o> 


Cm 

Ul 

V) 


» 

< 

as 

x 

o 


♦ H M 


rn  O 

'N  <J\ 

rs|  co 

rvj  f* 

4 Ml 

<N  U1 

1-4  4J 

<N  (*i 
<•4  <N 

<N  r- 

(N  o 

«-  tTi 

*-  UO 


4 MMMMM  4 M M M M 4 4 ♦ M M M M M ♦ M M M M M 4 


M 

O 

r-  r- 

iX 

<D 

iu 

*- 

c»< 

U) 

«M 

1 

in 

t-  u> 

(» 

M 

n 

id 

»"  J 

G 

1 4 

U. 

U 

r-  m 

m 

r-  im 

<d 

G 

>1 

f t— 

iO 


r* 

» < 

Ul 

• 

M 

<n 

n: 

' « 

sr. 

O 

10 

in 

M 

M 

in 

in 

u« 

>* 

-r 

«n 

> 

♦n 

•< 

•< 

o 

o 

|>4 

H H M M H 4 MMMMM  4 

X 

X 

X 

HHMHM  4 ItHHHH 


I I M M M H 


IMtHIHM 


4 H H H H 4-1  4-  MMMMM  4 M M M M 14  4 M M M M I I 


H M *4  M M 


llll  H hlH  4 i 4 M I t M M 4 M M I 1 • I 14  4 


4 1-4  M 44  M M 4 MMMMM  4 HHHMH  4 H 1-1  (•<  M M 4 I I 14  II  H II  4 


I 4 M M M H ♦ M M 4 H 14 
X 


M I I M M M 4 M I 4 M M II 


M I)  I * 1-4  It  4 


II  1 4 I I I I I 


I • 

4 MMMMM  4 H H H H M 4 MMMMM  4 MMMMM  4 H 14  H H 

io  r»  on  oi  o rNmam  vo  m co  cr-  o rN«3in  vof-'acu'C1 

NiNiNNm  nn*ii*imi*i  r*i  m m m ^ .a  ;» 


l<>.< 


♦ 

4-4  M 

H H 

M 

<n  o 

1 

«N  X 

O 

• 

O 

1 

1 

<M 

X 

ot 

M 

1 

o 

O 

1 

•< 

CN  » 

1 

f>4 

X 

o 

O* 

1 

o 

1 

1 

• 

X 

>4  >4> 

1 

1 

X 

1 

• 

*n 

♦ 

» i 1-4 

H » 4 

“« 

• • 

4'J  40 

1 

O) 

• 

O 

• 

• i 

4>4  =t 

1 

04 

1 

wm 

1 

» >4  0> 

1 

r* 

1 

1 

r- 

C4  «N 

I 

O' 

1 

T— 

1 

4 >4  «— 

1 

% 

1 

I 

♦ 

14  14 

4 4 14 

1 ( 

4M 

1 

|\l 

1 

1*1 

40 

r-  o> 

1 

1 

V 

X 

r- 

i 

1 4 

1 4 

» 

M 

m« 

i 

• 

1 i 

f 

r*> 

'C 

i 

; j 

* 

J»", 

♦ 

14  4 14  4 

• 4 4 4 

O 

10 

n> 

i 

1 4 

1 4 

i 

1 i 

4M 

i 

U« 

X 

i 

o* 

HI 

i 

O 

> 

i 

<n 

i 

• < 

t 

IH 

i 

Cl 

u 

» 

4 4 

i 

% • 

• 

*< 

r*> 

i 

i 

X 

t 

♦ 

M M M 

H N 

♦ HMHMM  ♦ HUH  H H 


♦ M M II  ' 4 • I 


M M M * * H ♦ 


M HI  I H M 


♦ I *4  4 I I I I I I 4 


MMMHM 


M M M H ♦ 


IIIIHHH 


HHHHH 


♦ I I I 4 4 I 1*4  I I 


iihhhh 


H H H H H ♦ 


HHHHH 
• >4 
I V* 


♦ I 4 M I I ► 4 I 4 


♦ HHIIHH 


♦ M » » I 4 I I M 


M M M M M ♦ 


14  4 4 1-4  • I 14 


♦ I I M I 4 i 4 » 4 


♦ I 4 * 4 » I i I »-4 


ItHHHH 


♦ HHHHH  + HHHHH  ♦ HHI-4HH  ♦ H HHnH  4 M M M H M ♦ 

f <n  ^ \or*crt*No  ^ rs  rn  ^ in  vo  ^ ro  c’'  ^ cni  o>  10 

»n  u>  u">  4n  »o  40  m in  i/i  vn  no  so  vo  vu  u>  \o  vx>  vo  r*  r*  r* 


M M M M M 4 M H M M M ♦ M M M M H ♦ M M M M M 4 M M M M ♦ 


4* 

U 

O 

a. 

<u 

p. 

r-  O 

lP 

i/i 

CN 

•H 

1 

V) 

r-  in 

W 

>. 

lb 

r— 1 

3 

>0 

r-  t 

V 

(0 

I 1 

Iv. 

u 

<o 

•H 

a 

r (S 

10 

u 

>* 

r*  r* 

a 

X 

• «cj 

t * 

<n 

U4 

• 

1 * 

SO 

< 

» 

o 

■r4* 

to 

in 

9 M 

M 

to 

04 

X 

J- 

m4 

< 

n> 

•< 

UF 

u 

CN 

M H M H H 


H H H H H + 


4 M M M t t M 


♦ M M * I M M 4 


MMMMM  4 MMMMM  ♦ MMMMM  4 M M M M 4 


HMIIHM 


M M M M 


M M M t 4 M 4 MMMMM  4 HHIIMH  4 M M M M M 4 M M M M 4 


MMMMM 

cu 


MMMMM  4 M M M M t4  4 M M M M 4 


MMMMM  4 MMMMM  4 M M M M 4 


M M M M 4 


4 MMMMM  4 MMMMM  4 M M M M I * 4 MMMMM  4 M MM  M 4 


lOMpO'O  r-  (N  '’l  ^ in  id  h IT  O'  o *-  Cn|  m :*■  in 

flOOOOOOOuO  00  00  00  <T>  CP  tP  O'  CP  CP  CP 


vii  p-  00  O' 
O'  O'  O'  U' 


♦ 4 I M M 1 4 H ♦ 4-4  4-4  4-4  44  4-4  ♦ 4414441141*  14  4-  4 4-4  1-4  M ♦ H II  M M )|  ♦ 

I I I • (N  | | 

* I I l •*.  I I 


in  04 

< 

• 

«c 

i 

i 

o> 

in  *- 

i 

r- 

i 

• 

i 

♦ 

1 4 

V4> 

m o 

i 

*— 

» 

CL 

^ Ch 

i 

i 

W 

i 

in 

5 

ct  ou 

i 

1 

-r  r- 

1 

1 

u 

1 

o 

1 

CL 

L 

6 

1 

01 

1 

n; 

1 

♦ 

04 

O' 

i/l 

in 

1 

CM 

•H 

1 

1 

t/i 

1 

W 

^ -4- 

1 

iu 

H 

1 

o 

<0 

« 

o 

e 

o> 

1 

1 l 

•*. 

t 

U-* 

1 

u 

=*  cs 

1 

•H 

1 

B 

1 

<0 

■4  f- 

1 

CJ 

1 

^4 

1 

Q 

♦ 

M 

4 o 

( 

1 

«*>  O' 

1 

1 

1 

»o  CO 

1 

1 

1 

rv> 

1 

1 

r- 

X 

( 

1 

0« 

M 

»u 

1 

O', 

1 

• 

1 

ci 

**. 

♦ 

M 

< n in 

1 

O 

»/) 

f 

1 

M 

•o 

1 

01 

0) 

1 

iU 

04 

1 

•0 

,4 

n m 

1 

•< 

:> 

1 

-< 

• i 

TM 

1 

1 

Hi 

1 

S3 

L) 

1 

M 

r»>  r~ 

1 

M H -4  H H ♦ 


II  II  H I I H ♦ 


44  M M 44  ♦ 


• 4 M M 44  M ♦ M M • -!  M -I 


M II  H M M ♦ 


14  M 44  44  44  * 44  M 44  M 44  ♦ I 4 I I ( -4  i 4 » -4 

t U I 


I I I I II  M M 


14  -4  4 H 14  ♦ II  H H H 4* 


MIIMH  4-4 


* |-4  4 4 H W M * 4-4  1-4  4 4 I I » 4 ♦ 414444444-4  * 4 4 4 4 4 ( 4 ) 4 4 * 


4(44444444 


4 4 44  44  I 4 44 


4 4 44  4 4 4 4 4 4 4- 


♦ H 4-4  14  4-1  H ♦ H H M H H ♦ 44  4-4  4-4  4-444  ♦ 4 4 4-4  4 4 44  4 4 ♦ H 14  14  44  4 4 ♦ 

f"~  TO  O'  O r IN  11(1  vO  CV  O'  O r-  ("4  & ITI  (P  r-  t 1 

rsjrvjrvjAjno  fOKN^mro  oo  '”■>  ro  ori  t 4 T t T S .4  4 t in 


CO 


«**  y) 

<N  -H 


H I * M M M ♦ >1  t I H H H ♦ M M M 


♦ M M M M M ♦ M M M M M ♦ 


M M H M M ♦ HMHHH  ♦ 


H M H H H ♦ M I*  I M M M 


H H M H M ♦ M M M M 


M • » H H M 


M H H M M 


♦ M H H H H 


h « »H  M M M 
rO 
*< 


H M M M ♦ M H M H M ♦ 


HHHHH 


M »H  M M M 


» i M M 1-4  M 
X 


M M M M 
X 


M M M M M 


M M M M M 

X «n 


♦ M M M M ♦ 


M M M M M 


M M M M M 


I -4  H M »-4  *H  ♦ 


M < < M M » < + 

O X | 


♦ H M M M M + 


♦ M H I H 


I I I I I 

M M W H M ♦ M M M M M ♦ M M W M M ♦ M M M M M ♦ M M M M H ♦ 

r-  fN|  t in  VO  0L>  f7N  O r-  ^ Cl  .*t  tn  vO  OP  Ov  *3  r *N  cr>  ^ m 

in  m in  n m in  in  «o  \£>  \r>  v©  vo  vo  vo  v©  v©  vo  r* 


a 

s£> 


(/> 

lM  H 

I to 

»a  m 

r>  >ti 

O c 

i < «*. 


H M M H ♦ H H M H H ♦ M M h4  M M ♦ ♦ 4 M H M H 

I X I I 


M M > I H 


H H H H H ♦ 

< 'M  I 


►-«  M M M » « 


1-4  I I M M M ♦ 


1-4  M M M M 


> « » i * l » i M 


H M »H  M ♦ 


M M M M 


H II  H M H ♦ 


M M H M M 


M M M M hi 

m 

U 


MM  4 H H 4 M '<  '1  H H ♦ 


M hi  M M H 


H M H M M ♦ M M M M M ♦ M M h«  ♦ •«  ♦ 


hi  M M M M 

o 


M M H I I • ! ♦ I I H ••!  M H 


M H H H H ♦ M H H H M 


HM  hMl 


M M » I M ♦ 


« « *-4  I 4 > « ♦ 


H H H hi  H ♦ HH  HH  H ♦ HHHHH  ♦ M M M 


♦ M M M M ♦ 


^ ® |1\  n <r-  OJ  I'O  & lO  vO  TM*  O r*  fM<^  } ^ vi>  h*  ^ 

m co  cc  t*  a>  on  or*  <p  <r  cr>  o>  o (M^  C' m ^ iin 


*4J 


to 

to 

P 

:*l 

P 

ex 

a 

a 

CO 

a* 

O 

% 

O 

% 

i- 

o 

.a 

M 

> 

-r. 

to 

i « 

n 

•r  1 

o 

•rt 

•< 

u 

Mi 

w 

*r 

u*. 

P 

T3 

O 

tT»  01 

!P 

hi 

t/l 

p 

0> 

K4 

•H 

rH 

1*4 

1 4 

hi 

u 

*4 

O 

► 0 

•H 

P 

X* 

T1 

3 

1*4 

O’ 

M 

p 

p 

X. 

« 

•X 

to 

4-* 

.1 

o 

4-> 

,3 

O 

0 

P 

• 4 

p 

o 

o 

it* 

M4 

X 

ft 

p 

p 

it 

O 

u 

u« 

> 

4- 

» 4 

i' 

t « 

rr 

u. 

O' 

P 

03 

P 

O 

U 

«l 

?»J 

n 

*1. 

M3 

u 

k*  * 

P 

u 

1 i 

x: 

to 

iX 

p 

ip 

iJi 

t-4 

H-4 

• 

14 

P> 

u 

o 

o 

•p 

V 

P 

03 

1-4 

«c. 

•r4 

to 

10 

Ur 

o 

P' 

p 

• 

O 

t ) 

M« 

P 

-C 

O 

to 

f.l 

C/) 

1-4 

o 

Ml 

a. 

P 

o 

<h 

0 

-P 

P 

to 

tj> 

01 

T3 

iO 

<•5 

9 

*-n 

p 

•— » 

43 

rt? 

U J 

O' 

to 

P 

P 

•C 

hi 

c 

• O 

03 

u 

o 

O 

CJ 

U- 

p 

4-* 

rs 

«T3 

M 

p 

U 

to 

• 

O 

I -4 

4-> 

P 

O 

^3 

to 

1*4 

a> 

P 

<0 

'■C 

to 

1 

to 

03 

a 

p 

>* 

O 

P 

•»4 

1 1 

/. 

03 

sz 

*P 

hi 

U 

to 

*»4 

o 

4* 

o 

o 

o 

U4 

M 

P 

•H 

X 

O 

:c 

o 

o 

to 

p 

P 

1 ♦ 

1 

a- 

I, 

f-4 

•t5 

P 

r~4 

03 

P 

♦ -« 

o 

1 4 

cr 

p 

X «< 

«T. 

E 

r_> 

<? 

U 

P 

l> 

•; 

O 

.P 

a. 

M 

4 

u 

• 

f-4 

55 

!3 

X5 

J 

C 

•r  4 

<T3 

in 

Ml 

O 

»r. 

& 

r* 

O' 

u 

til 

r 4 

o 

1-4 

•< 

M 

0.4 

m 

1 4 

1 t 

C 

» • 

» 

r«-* 

*3 

CH 

» i 

l>l 

*3 

to 

x: 

►A. 

at 

o 

»r 

«p* 

t/l 

•r4 

; ; 

t 4 

X4 

lu 

n 

P 

•r 

1 1 

1 « 

m 

• 

•r4 

♦-* 

M4 

itl 

t/3 

>. 

u. 

*x 

4 

u 

•rH 

•P 

OJ 

*P 

• 4 

1 < 

'V 

a 

>< 

O 

M 

>- 

> 

P 

hi 

P 

0 

to 

•H 

s 

IT, 

p 

4 4 

♦ -4 

a 

p 

W. 

P 

M 

5" 

*tl 

o 

U 

«TJ 

•p 

l-» 

) 4 

c 

e 

H 

> 

c; 

l « 

O 

♦ » 

to 

CP 

*4» 

U 

4. 

»: 

u* 

c 

H 

V’ 

U’ 

Et* 

L' 

y. 

M 

p 

• 

03 

r*i 

P 

% 

it. 

03 

IT, 

p 

iti 

X- 

k.« 

o 

•P 

XT 

to 

O 

O 

•r4 

o 

>1 

P 

o 

Ml 

0 

V.) 

(U 

P 

O 

O 

r* 

4J 

P 

b> 

vi 

»*« 

>4 

► t 

1 t 

14 

5-*i 

hi 

•r 

u 

l • 

> 

U 1 

<TJ 

P 

1-4 

1*7 

<T5 

H 

P 

o 

« u 

at 

l -4 

CP 

i-X 

fC 

*c 

•p 

m4 

• 

1 ll 

•P 

GT 

% 

V 

tO 

V *4 

O 

1 4 

•^4 

O 

Ci 

3 • 

a 

p 

H 

r>  u 

vO 

‘O 

P 

nj 

t i 

55 

p 

to 

C 

«.) 

*.4 

ul 

o 

iO 

•H 

•4 

14 

p 

t 4 

C» 

to 

;n 

P 

H 

l 4 

o 

o 

0* 

th 

to 

M 

i < 

Ml 

V« 

u 

•H 

C< 

1 4 

V 

> 

I « 

1> 

Mi 

!M 

t • 

P 

U« 

1 « 

•P 

u 

•rH 

•H 

u« 

rr 

U. 

o 

0) 

»•» 

4* 

x: 

■r4 

4*. 

SI 

IL 

U 

u« 

•P 

tr 

«-« 

u 

P 

»• ! 

u. 

»1 

u 

1 1 

‘"'I 

O 

« 4 

1 1 

m 

» 4 

4 » 

o 

rr 

10 

M. 

• ii 

♦ 4 

X 

*3 

•f4 

O 

',*. 

et' 

o 

c 

1 4 

%u 

r. 

P 

• r4 

Ii. 

*0 

d 

O'- 

C? 

* i 

to 

l'« 

• 

r 

1 4 

C'4 

*-• 

P 

1 4 

P 

p 

cu 

o 

.r: 

1 . 

r*> 

V5 

P 

a» 

er 

► H 

I < 

O 

l 4 

o 

.\3 

E3 

o 

U3 

o 

0> 

it) 

O 

p 

♦ 

1 » 

’A. 

o 

u 

O 

x: 

<r 

tCr 

% 

l»4 

n 

• 4 

•H 

ir. 

x: 

14 

_P 

>4 

5r. 

5” 

vJ 

u 

ffl 

3 

p 

to 

1 « 

L * 

1 • 

IH 

cu 

P 

* 

O 

P4 

c; 

to 

p 

> 4 

1 

to 

«; 

rr 

,_-. 

u 

O 

01 

cp 

t/i 

hi 

<n 

to 

0‘ 

0* 

s*. 

fO 

w 

O 

p 

4> 

i * 

Mi 

M 

IX 

1 4 

•H 

% 

P 

rvi 

rEJ 

0 

• 4 

M 

0 

% 

CJ 

i;« 

*1 

T.. 

3 

a 

o 

> 

< > 

2”. 

P 

P 

O 

03 

to 

O 

O' 

-C 

r0 

O 

'▼I 

f-' 

Vi 

ip 

M3 

n 

P"TN 

-Q 

IO 

1 1 

CO 

O 

0 

4* 

01 

5" 

Ml 

a 

. u 

H 

U) 

• 

*d 

>- 

a 

1 • 

0 

O' 

to 

P 

to 

p 

i 1 

CO 

Ui 

% 

iv4 

X 

*P 

•** 

1/3 

vl- 

% 

• 

10 

• • 

• • 

P 

vp 

r— 4 

• • 

•P 

3 

• • 

•p 

>; 

rr 

• ■ 

t/J 

o 

O 

t«4 

*v 

f? 

P 

O' 

M 

V 

r— 

«N 

f ? 

*p 

tr 

P 

a9 

p 

Mi 

< 

if'i 

•1 

1 ' 

« 

U 

h 

»0 

1 « 

P 

R 

x: 

5> 

a 

Q. 

P 

a. 

(M 

u 

u 

p 

I -4 

55 

o 

M 

H 

o 

«U 

p 

• 

• 

i-1 

•H 

to 

• 

O 

• 

t 4 

• 

o 

vV 

ill 

1 t 

p 

I 4 

'O 

• 

u 

rH 

O 

O 

CO 

p 

•p 

o 

Ui 

o 

to 

p 

o 

Ml 

> 

M 

O 

</3 

>* 

it 

> 

X. 

«44 

;; 

<•*< 

v 

•r4 

irv 

•P 

•4 

55 

•p 

p 

o 

r*. 

cv. 

0’ 

to 

»P 

•P 

o> 

o 

o 

Uj 

P 

CO 

V./1 

O 

10 

4 

M 

■< 

P 

t 4 

to 

(4 

U 

o 

to 

V 

to 

to 

O 

C 

*0 

U 

O' 

% 

o 

a 

VP 

to 

•P 

m 

> 

!.•* 

ft 

03 

•H 

LL 

T 

-r-4 

H 

»•* 

si 

••  4 

IM 

•r4 

*rv  m; 

•P 

tr> 

*-5 

•r4 

O' 

o 

ii) 

iU 

o 

> 

P 

1-* 

*• 

u 

4^ 

in 

U4 

p 

<e« 

U) 

C." 

♦J 

> 

a 

P 

1 4 

kl 

o 

tT  *P 

•H 

o 

V3 

o 

P 

o 

to 

to 

1 

IC 

to 

M 

H 

to 

•p 

a 

o 

•ti 

0) 

tr 

o 

P 

«3 

c: 

o 

O 

»*• 

% 

ai 

u; 

o 

to 

O 

c 

10 

a, 

r 4 

o 

a1 

ic. 

to 

• 

M 

rt? 

t0 

H 

•H 

rtJ 

c 

C 

fL 

to 

p 

cu 

p 

a> 

55 

c 

03 

r> 

m 

c 

o 

Qi 

to 

hi 

T3 

i 4 

H 

•H 

x: 

P 

a 

rr 

rr 

to 

03 

n* 

R 

M4 

rr 

n 

IU 

C4 

r* 

0 

c 

to 

Q‘ 

>: 

T3 

P 

p 

e 

0J 

to 

O 

hi 

H 

a 

IT 1 

>: 

«• 

1*4 

Vr 

(T3 

x: 

a> 

P 

04 

-< 

x> 

*< 

03 

V 

•r4 

•H 

P 

U 

<tJ 

03 

•p 

to 

o 

*p 

to 

10 

O 

•H 

♦ ' 

53 

a» 

u 

*1 

c 

y; 

<V 

a/ 

B 

p 

43 

n 

O 

O 

P 

> 

o 

•H 

u 

Q 

•p 

M 

o 

Q 

rr 

> 

O 

•p 

>4 

x: 

u 

o 

o 

x: 

vp 

«i4 

<0 

•H 

x: 

hi 

si 

ua 

04 

0' 

•p 

Ou 

P 

p 

a 

« 4 

*5 

w 

CL 

r • 

• 

1 

cx 

IX 

Cr> 

• 

r 4 

ra 

1 

1*4 

M 

ttJ 

9 

H 

to 

tr 

X 

O 

a 

o 

•n 


o 

' M 


<0 

CO 

4 

J 

O 

a 

o 


H 

to 


u u 
o o 


o o o o o o o o o o o o o o 


5Q 

o 


A 'A  A 

o o o 


-a  A 

o o 


7 sc 

o c 


PO 

►H 

M 

M 

M 

M 

M 

M 

M 

M 

M 

M 

►-♦ 

4-4 

4—4 

o 

o 

o 

c> 

C 

e 

tr 

O 

C 

W 

tr 

0 

O 

? 

i « 

i- 

(-• 

t i 

F 

L< 

H 

h 

1 4 

fj 

l 4 

t 4 

lr< 

V* 

V. 

5*. 

S2 

v, 

P5 

V5 

SO 

so 

Vi 

Si 

,5 

55 

V 

rt. 

• • 

o 

u 

u 

u 

u 

u 

u 

u 

(J 

U 

u 

U 

U 

4-1 

IH 

H 

4-4 

M 

4-1 

M 

M 

4-  4 

4 -4 

4H 

M 

1 4 

4 4 

4-1 

vN 

«< 

-c 

*< 

*x 

rt: 

< 

*< 

< 

-* 

rt 

*c 

«< 

-< 

ro 

to 

to 

rr» 

C/1 

to 

to 

t/1 

to 

to 

to 

to 

to 

to 

'•) 

r~ 

CD 

U) 

to 

to 

to 

t/< 

t/4 

to 

to 

to 

to 

t/i 

to 

to 

to 

If* 

>< 

>* 

X 

X 

X 

X 

x 

X 

X 

>* 

>-• 

>- 

w 

M 

til 

W 

r»i 

W 

<0 

PI 

ro 

ru 

f) 

X 

P 

U4 

vs 

55 

55 

A 

VR 

5D 

A 

A 

A 

u 

u 

o 

u 

u 

L> 

U 

u 

U 

u 

u 

U 

W, 

O 

r* 

PO 

-< 

< 

< 

< 

<< 

*< 

-< 

< 

< 

< 

< 

-< 

o 

o 

e 

0 

0 

O 

O 

0 

O 

0 

0 

O 

O 

C 

r* 

.4 

l>4 

U4 

a. 

CD 

U4 

1x4 

4X5 

05 

fD 

X 

Uj 

ir: 

Ua 

0 

f D 

M 

ft  4 

Id 

14 

►4 

i«4 

Ul 

U4 

Pi 

U4 

U4 

w 

ixj 

cu 

CD 

IX 

(X 

(X 

(X 

(X 

CD 

CD 

X 

X 

X 

X 

0. 

CD 

r* 

O 

t-‘ 

l-» 

H 

t-i 

H 

l-l 

H 

H 

fc-4 

H 

k * 

1-4 

H 

t-4 

ic 

«u. 

•a. 

< 

•J. 

*». 

*< 

< 

«* 

it 

•a: 

< 

< 

K 

Ha 

u- 

4— 

a. 

ID 

(D 

ID 

ID 

CD 

ID 

ID 

► D 

u» 

D« 

ID 

% 

ID  O 

M 

M 

M 

♦ -4 

M 

4 4 

M 

4-1 

hi 

M 

M 

4 1 

M 

M 

ro 

U4 

ru 

c . 

ftf 

r» 

r»» 

M 

1C 

U4 

r 

h' 

it) 

l’ti 

(•: 

w 

U M 

L-* 

H 

F» 

l-i 

H 

t < 

H 

H 

b~i 

H 

Li 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

x 

* — 

r < 

1 -4 

hi 

4 1 

i 4 

M 

M 

M 

hi 

M 

M 

M 

4-1 

1 < 

h~* 

H 

f-* 

H 

H 

1 4 

Li 

H 

F* 

r * 

f-4 

c 4 

f 4 

i 

a i « 

•.— 

•,* 

V*. 

*• 

52 

A 

5" 

• ^ 

*-?5 

45 

V5 

• n 

tD 

cD 

ID 

UD 

05 

* D 

ID 

ir4 

u, 

1 r, 

ID 

fD 

(D 

x 

c*  n 

1 l 

) 4 

M 

♦ -1 

4 4 

H 

M 

M 

4-4 

M 

M 

h4 

M 

M 

ra 

O 

tr> 

r> 

O 

tD 

C3 

O 

X 

X 

X 

4 

li*  ’a.*4 

fv« 

u- 

U4 

C1-1 

U-4 

(D 

X 

X 

X 

u* 

X 

X 

X 

ID 

p. 

('1 

1 4 o 

i « 

( * 

H 

H 

M 

r « 

i-i 

H 

H 

1 < 

l» 

I-* 

H 

u 

o 

a 

O 

o 

a 

o 

O 

o 

O 

o 

O 

o 

a 

a 

O 

a 

O 

u 

O 

O 

O 

O 

0 

0 

O 

O 

0 

O 

0 

u 

n .i. 

S'”. 

55 

sc 

« 

A 

55 

*X 

A 

A 

vi 

5*i 

A 

Vi 

Vi 

«u 

i - 

*■* 

Vi 

V5 

•* 

* • 

A Z 

s*. 

A 

A 

A, 

♦ ' 

D J • It 

••  J 

to 

o 

*0 

0 

r0 

D1 

o 

:o 

-0 

m 

n 

'J) 

-0 

U) 

10 

to 

O 

CO 

t/1 

4.0 

^0 

1 

40 

O 

10 

0 

to 

O 

l« 

14 

4 

♦ 4 

u4 

0 

'4 

tii 

f*l 

• *4 

u 

lu| 

ix4 

UJ 

ni 

M 

fw| 

tu 

10 

XI 

10 

lil 

f»  1 

tl) 

4C 

M 

p; 

iC 

o 

o 

o 

o 

O 

o 

O 

o 

O 

O 

o 

a 

O 

o 

o 

o 

O 

Q 

O 

O 

O 

O 

O 

O 

0 

O 

0 

O 

0 

O 

a. 

U 

ro 

n 

a 

o 

o 

Cl 

a 

a 

Q 

n 

n 

n 

n 

a 

C-J 

a 

Q 

a 

O 

D4 

O 

f'i 

f4 

a 

IU 

X 

a 

iU 

«n  j-  m r-  r-  r* 


, , .1  r-  n <»i  cf  m mj  oo  ^ n ^ i>  Mt)  o <’)  4 •/)  \o  o J 

og  <n  m co  «o  <o  m m m m m in  m vo  vd  p-  r-  r*  r^-  r^  <r  a 


.< 

:< 

r« 

:« 

3 

:« 

3 

3 

rx 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

:« 

3 

3 

C« 

3 

3 

r— 4 

0 

0 

0 

0 

0 

O 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

O 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

T5 

•j 

D 

it 

tit 

i>t 

c 

cti 

tit 

l«4 

M-* 

ID 

M, 

ID 

l D 

»; 

ID 

tU 

1 D 

u* 

tD 

» D 

ID 

ID 

iD 

D 

ID 

1% 

IT. 

Hi 

1: . 

C 

-J. 

'w' 

( 

w’ 

w 

Vl" 

w’ 

W’ 

w’ 

W 

“ 

w’ 

w’ 

w- 

’w' 

*** 

W 

W' 

w 

s‘^’ 

c 

c* 

• H 

to 

4-4 

t/) 

t/) 

UI 

P; 

P) 

to 

if 

Pi 

P) 

Pi 

to 

P) 

Pi 

P) 

PI 

t: 

CO 

L 4 



. — . 

. — . 

. — . 

- — . 

U) 

to 

l I 

Pi 

P) 

to 

Pi 

to 

Pi 

P) 

to 

P) 

PI 

to 

Pi 

rU 

4H 

1 » 

t 4 

1 « 

1-4 

i • 

1-4 

C< 

t * 

1 * 

r ' 

t ■ 

n 

4 « 

PI 

pi 

:c 

M 

X 

10 

Ul 

PI 

r* 

X 

PI 

PI 

i«l 

U) 

(> 

c; 

<J 

O 

*vt 

‘A 

Si 

j.*. 

V. 

Vi 

s*i 

'A 

55 

*/ 

55 

w 

5% 

u 

u 

u 

U 

u 

u 

u 

CJ 

u 

0 

CJ 

u 

u 

CJ 

O 

>- 

0 

X 

Pi 

PI 

Pi 

lO 

ID 

1-4 

Pi 

l<) 

Pi 

X 

M 

ru 

l>) 

CJ 

0 

C’ 

c 

CJ 

0 

0 

0 

0 

0 

a 

<-.) 

0 

O 

1 1 

ID 

0 

> 

> 

>■ 

> 

> 

> 

> 

> 

> 

> 

> 

<D 

D 

ID 

«D 

ID 

u 

‘D 

ID 

.0 

X 

D 

Ua 

iD 

iD 

*D 

X 

0 

rO 

i‘l 

10 

.0 

‘t| 

•1 

UJ 

1 

>1 

til 

1 

pi 

U4 

X 

U« 

X 

X 

n* 

ID 

X 

iD 

CD 

X 

X 

X 

ID 

X 

ID 

>— » 

t—** 

D-* 

■*— * 

■— » 

"t- 

to 

>1 

0 

f 

i 

1 

D* 

CJ 

G 

-< 

i 

pi 

t 

•H 

•H 

>. 

O 

<n 

1 

fi 

, 

B 

fT"? 

H 

C 

'0 

i 

CD 

1 

• H 

H 

CJ 

3 

C' 

O 

G 

j. 

•j 

1 

►1. 

1 

t 

1 

a* 

CJ 

•r-4 

O 

CJ 

*— 

5 ’. 

» 

10 

1 

Ct 

u 

c 1 

to 

CJ 

i5 

c> 

•H 

d 

<r 

Hi 

1 

to 

1 

O 

O 

1 1 

1 

1 

O 

in 

C-V 

<V 

CJ 

t- 

n 

to 

1 

PI 

1 

• rj 

•H 

a 

•V 

X 

•H 

•3 

in 

CJ 

n 

.D 

• 

10 

f 

>: 

1 

c 

c-» 

C-* 

0 

B 

E 

CJ 

•H 

u 

t? 

3 

G 

e 

m 

1 

1 

<r 

•H 

• 1 4 

•rl 

O 

G 

* — 4 

0) 

X 

f 

O 

0 

55 

1 

pi 

1 

a 

U 

1 

C-’ 

u 

O 

♦> 

m 

a 

X 

to 

•H 

•rl 

G 

V. 

Pi 

‘4 

1 

pi 

1 

•H 

♦H 

ry 

n5 

1 

1 

•H 

3 

> 

<D 

3 

1 

G 

cJ 

c 

•H 

, > 

1 * 

• 4 

4 4 

1 *1 

1*4 

1 

'CJ 

ICJ 

cl 

U 

u 

to 

cJ 

X 

1 

c^  a> 

1 

to 

O 

a>  r 

U 

41 

% 4 

4/1 

t*I 

1 ♦-» 

Vi 

1 

•H 

•rl 

•H 

■H 

*n 

0 

c 

cz 

in 

B 

c 

1 

CJ 

to 

c 

•H 

c-J  3 

O' 

to 

D| 

>* 

►-J 

1 

M 

1 

't* 

Dl 

14 

C 

‘Ci 

U 

*CJ 

0 

0 

*j 

O 

0 

>«. 

IT3 

G 

0 

C’ 

3 

il 

•rl 

tli 

X 

1 'O 

L -4 

1 

Ca 

ai 

vi> 

to 

•rl 

3 

1 

r-4 

r-| 

3 

O 

•H 

u 

t: 

O 

•H 

0 

TJ  r-4 

u 

rl 

1 

't 

r 

1 Q< 

i»l 

1 

3 

> 

> 

*H 

tJ 

O 

CJ 

CJ 

c> 

X 

1 

cJ 

cJ 

x a> 

•r-| 

CJ 

3 

X 3 

O 

1 

> 

A 

0 

1 ? 

. J 

1 

O 

1 

f 

H 

<P 

VCJ 

C3 

<v 

t/) 

0 

IT 3 

6 

to 

53 

C 

3 

CJ 

C‘ 

u 

T3 

3 > 

U 

c 

<rs 

u 

1 k 

ID 

1 

c 

a 

1 

> 

1 

a> 

Ul 

•i) 

Vi) 

d 

3 

CJ 

O 

Ul 

CJ 

d 

<n 

U 

3 

a 

f | 

1 

0 

•< 

V. 

1 ^ 

1 

1 

Dl 

u 

*3 

1 

a 

> 

3 

a> 

> 

X 

tl 

O 

3 

T3 

3 

U 

3 

3 

l 

Tl 

3 

3 

3 

>-  3 

*r-| 

iD 

to 

► i 

1 e 

O 

1 

U 

O 

O 

tj 

d> 

lo 

•H 

O 

c 

4) 

•r*4 

.n 

3 

O’ 

tt) 

Qi 

1 

O 

Q.  tJ 

B 

a.  -3 

d 

1 

3 ii 

u 

c» 

*3 

u 

1 ^ 

U 

1 

O 

'CJ 

VCJ 

<TS 

B 

^3  DO 

»M 

0 

CQ 

CO 

4-» 

CJ 

a> 

Tl 

B 

B 

u 

a> 

3 

3 

!"U 

X 3 

3 

0 

M 

A. 

1 1 

V 

1 

u 

1 

1 

O 

<rl 

O 

1 

1 

1 

1 

1 

1 

1 

u 

1 

O 

1 

O 

O 

1 

1 

t: 

l 

3 

1 O 

U 

<r* 

>; 

J | 

1 to 

4 4 

1 

u 

a * 

X 

1 

*•> 

1 

* 

C» 

4-’ 

•«-> 

CJ 

CJ 

1 

> — 4 

O 

an 

O 

X 

to 

(0 

1 

d 

Ul 

to  | 

1 

Cl 

*< 

n 

1 p 

1 

V 

B 

B 

0) 

1 

U 

c 

C 

c 

c: 

c 

G 

c 

CJ 

« 3 

1 

l 

IT3 

1 

a 

u 

T3 

T 

cJ 

0) 

to  d 

O’ 

G 

5" 

x 

1 n 

3 

1 

l 

(D 

a> 

s 

H 

a> 

Q) 

0) 

0' 

<v 

<D 

a* 

•t*4 

CJ 

M 

CJ 

CJ 

>* 

u* 

3 

C 

U 

m 

TT 

O H 

B 

3 

>< 

0 

1 0 

O 

1 

0 

1 

1 

•M 

•H 

> 

> 

t» 

> 

> 

> 

> 

C 

0 

IT3 

d 

0 

IT3 

l 

O 

3 

•r-| 

jj 

a 

Ui  -H 

•M 

Ul 

Ci 

u 

• x: 

4D 

1 

r: 

to 

-r; 

•C’ 

to 

CJ 

<14 

CD 

4) 

a> 

ai 

0) 

a> 

CJ 

CJ 

c 

CJ 

XX 

X 

44 

‘CJ 

CO 

Uj 

3s  cJ 

C» 

»P 

Jj 


vp  203 


M 

H 

H 

Z 

VB 

Z 

'O 

M 

Ml 

w 

X 

'•« 

CO 

CO 

CO 

o 

M 

M 

4-4 

-< 

'0 

CO 

to 

04 

i; 

2; 

o 

O 

O 

u 

U 

u 

Z 

Z 

z 

M 

M 

>1 

5M 

>»• 

JO 

4 

.4 

.4 

in 

O 

«-4 

*-4 

cn 

<5  o 

(5 

O 

c 

e 

t? 

15  t5 

15 

t5 

15 

(5 

u 

u 

u 

o 

5«  X 

z 

z 

Z 

z 

z 

2 Z 

z 

z 

95 

3-— 

4-4 

P-4 

4-4 

• • 

M M 

M 

M 

M 

M 

M 

M M 

M 

M 

M 

4-4 

r 

i* 

CN 

to  to 

CO 

to 

to 

CO 

to 

CO  CO 

to 

to 

to 

to 

r- 

to  to 

to 

to 

to 

to 

CO 

to  to 

to 

to 

to 

to 

z 

7. 

4< 

ft*  ftt 

to 

to 

CC 

M 

04 

W W 

M 

IO 

Ml 

w 

>4 

>4 

U U 

u 

u 

u 

u 

u 

u 0 

O 

u 

u 

u 

ID 

X 

a 

r** 

o o 

0 

0 

0 

0 

0 

0 0 

O 

0 

0 

0 

r- 

to  ro 

X 

X 

iiU 

it, 

Lt, 

a,  ixi 

u. 

It, 

iK 

tt, 

M 

M 

X 

UN 

a,  a. 

04 

a. 

04 

Q. 

Cb 

04  04 

a. 

a. 

0. 

a, 

co 

ro 

10 

T-> 

IP  1^4 

u« 

►P 

IU 

CL, 

U4 

11,  It, 

M-4 

u- 

O, 

o. 

>H 

>• 

% 

ro  w 

;o 

(M 

UJ 

M 

w 

Mi  f«l 

M4 

U4 

ro 

to 

< 

-< 

vp 

X X 

JS 

X 

X 

X 

X 

X X 

X 

X 

s 

X 

>4 

t— 

Cl  (H 

tr-4 

M 

r < 

N 

1 1 

fr<  H 

M 

H 

IK  tL, 

na 

X 

CAS 

(t4 

iu 

LL,  (x; 

ir, 

iG 

fK 

X 

& 

f D 

ZD 

:=> 

X 

O 

X 

X X 

ZD 

D 

X 

ZD 

w 

X x 

X 

X 

u< 

u. 

X 

X u* 

X 

u. 

X 

X 

(O 

u a 

a 

0 

0 

0 

0 

u a 

CJ 

U 

0 

l_> 

z ;s 

z 

Z 

in 

z 

z 

z z 

z 

z 

z 

P 

to  to 

>0 

to 

CO 

to 

O Oi 

t/1 

c.0 

to 

0 

•H 

u 

» *4  ti) 

►*.4 

P J 

•u 

4tJ 

.0 

tv|  ro 

0 

ro 

c»l 

(/} 

»~r» 

o 

o o 

0 

0 0 

0 

0 

0 0 

a 

0 

0 

0 

1/: 

r: 

a. 

u a 

<4 

C-i 

0 

ti 

0 

n 0 

a 

c> 

X 

CD 

U; 

•ri 

1 

a* 

0 

*0 

U 4 

• — . 

. 

. — . 

. — . 

. — . - — . 

-• — ^ 

. — . 

*■ — . 

O 

cr, 

nry 

uo 

'O  r- 

< *i  >0  & 

vp  r- 

UN 

w 

a' 

UN 

w 

00  00 

CO 

00 

co 

an 

(T» 

cj\  rr» 

a> 

o> 

(JN 

CM 

C, 

0 

<M 

•H 

1 

0 

1 

to 

at 

u 

w 

3r  IK 

nr 

3 

y 

nr 

-K  ^ 

:t 

;* 

'< 

at 

CL 

X 

•H 

O o 

0 

0 0 

0 

0 

0 0 

0 

0 

0 

a 

>. 

X 

It? 

ku  i.r. 

tci 

»u 

.t; 

it;  11; 

UL, 

1L 

a. 

a. 

0 

at 

e 

L*? 

a 

■w 

' 

— ' 

■— r' 

P 

r3 

M 

** 

LXi 

It? 

• H 

X 

u 

0 

B 

. . s 

. 

«— V 

•—» 



. — *. 

— » 

it 

C. 

a. 

•H 

to  t/i 

<0 

C/4 

y) 

C/4 

t/i 

CO  CO 

CO 

CO 

CO 

to 

n 

U 

0 

CO  L*i 

CO 

to 

CO 

CO 

to 

U)  CO 

C/l 

to 

to 

to 

>N 

1 

X 

it? 

to  IU 

M 

M 

M 

w 

to  to 

w 

PJ 

ro 

to 

r—4 

1 

u u 

u 

u 

u 

u 

0 

u u 

u 

u 

u 

U 

u 

u 

OJ 

>• 

o o 

0 0 

0 

0 

0 

0 0 

0 

0 

0 

O 

D 

=3 

CT' 

a 

u,  a. 

U, 

Ai 

lli 

:ct 

It, 

IK  U, 

iK 

u, 

*4 

X 

0 

0 

a? 

04  Q, 

04 

r-4 

114 

Oi 

(Ai 

O,  04 

04 

a. 

4 

X 

-,3 

t • 

ri 

O 

• * 

c 

13 

-t: 

•a; 

rT 

a 

0 

0 

kJ 

0 

c 

u 

•r-4 

•r-4 

0 

•H 

0 

0 

P 

A’ 

•r-4 

rr 

P 

•r-4 

•H 

a 

It? 

T> 

4- 

c 

lM 

«T5 

P 

0 

a: 

r—4 

<t? 

•H 

O — 1 

U 

D 

u 

•H 

►4 

>D 

it 

1 

U, 

•H  <T3 

a' 

i 

r-4 

0 

P 

u 

a; 

CO 

• 

n 

ro 

*•>  > 

a 

U 

a> 

•H 

ITJ 

1 

1 

a 

0 

1 

T1 

D 

• 

•H  O 

a> 

c 

u 

T-} 

p 

u 

U 

C3 

0) 

15 

1 

d> 

U 

CO 

•c  B 

CT 

•r-4 

1 

i 

a» 

u 

U 

cr» 

1 

.C 

O 

t3  a 

1 

ti 

a 

C 

p 

C4 

•r-4 

•r-4 

1 

'0 

1 

to 

14 

] 

z 

'O 

<t?  u 

>*  to 

0 

0 

0 

a; 

P 

P 

Ml 

1 

•r4 

Q, 

Q 

M 

1 1 

u 

a- 

•r-4 

•r-4 

cx>  tn 

<T5 

14 

1*1 

1 

> 

13 

1 

M 

CO 

a' 

p 

0 

4-* 

P 

>4  B 

1 

E 

b 

P 

>; 

1 

rl 

• r4 

O 

to 

>- 

*"H  r—4 

13 

0 

<n 

»T5 

u 0 

U 

u 

c 

1 

«n 

X 

c;» 

1% 

•H  *H 

0) 

M 

E 

B 

IT3  U 

1 4 

0 

0 

a» 

1 

a» 

1 

s 

1 

M 

*< 

*M  X* 

1 

Q. 

t-j 

U 

U I 

p 

U-l 

U-4 

1 

u 

1 

14 

a. 

0 

> 

1 1 

P 

L 

0 

0 

-Q  >» 

c 

a 

C 

p 

z 

1 

1 

P 

r—4 

P P 

M 

•m 

P 

•H  aj 

a; 

•r-4 

•H 

Ul 

UJ 

• 

w 

It? 

u.. 

< 

<3  c: 

O 

G 

13 

r-4  n. 

t 

I 

1 

0 

l-t 

1 

•o 

•c 

n 

O, 

lO 

at  a> 

O 

a1 

•r4 

•H 

<D 

1 1 

P 

»r*  xj 

a. 

to 

1 

1 4 

u. 

•r 

13 

u 

E 0 

0) 

1 

1 

1 

C 

w w 

u 

04 

a> 

CD 

4-4 

1 

it? 

r? 

1 

M 

*J  4-> 

u 

>- 

>, 

O 

in  <n 

0 

•r4 

•H 

u 

to 

1 

u 

1 

>, 

i; 

U 14 

1 

r-4 

r—4 

r—4 

1 

<L  O 

X 

U 

P 

1 

i « 

1 

» 

w 

r-4 

< 

ft?  it? 

0) 

M 

U 

M 

a> 

U tj 

<v 

n? 

It? 

0 

0 

1 

u 

t4 

z 

a.  a.  u 

3 

3 

0 

0 wu 

r-4 

r—4 

u 

0 

1 

R 

33 

33 

>« 

a,  at 

•r-4 

0 

0 

0 

<v 

t-t  1 

» 

It? 

at 

z 

1 

•r-4 

0 

0 

to 

TJ  TJ 

jd 

x: 

-C 

c 

04  to 

w 

w 

w 

P 

4-4 

f 

44 

.13 

44 


M H C-« 

14 

hHH 

H 

H 

H 14 

Q 

SO  SB 

SO 

VU 

ue 

SB  X 

X 

X 

X 

J5 

Ul  M M 

w 

ul  rft 

M 

M W M 

ul  M M 

CO 

w 

o 

> > 

> 

► 

> > 

> 

> > 

> 

► > 

> 

> 

> 

(J 

'il  HI 

■1 

4 

>1 

VI 

>1  M 

H 

g 4 

U4 

<0 

0) 

1 4 

ft 

n 

4h 

ft 

3 

•H 

p 

•H 

•H 

■«H  ft 

T) 

ft 

a> 

ft 

C 

a 

a h 

0> 

•H  ft 

■ 

p 

•H 

•H 

•H 

•H  ft 

o 

• -H 

U 

i 

a 

• 

1 

• -H 

o 

C ft 

a> 

u 

iO 

•H 

O' 

h2 

ft  • 

h 

O H 

p 

o 

O 

• 

t3 

O 

O CP  ft, 

H • 

i 

•H 

fv3 

CP-H 

•H 

•ri 

H ft 

4 

P P 

ft  ft 

a 

P 

H 

a a 

ft  H 

M 

•H  H 

id  o 

o 

id 

*4 

•H  H 

10 

<d 

10  tfl 

U 

C G 

U -H 

•H 

u 

♦ i 

Ul  1 

a> 

u 

U Ul 

0/ 

•H  *H 

•H  ft 

v 

•H 

n 

Ul  CP  o 

•H 

•rt  01 

H3 

I 1 

<ft  Id 

id  hj 

tr* 

o,  a>  a 

o 

<44 

<ft  u 

o 

Oi  Oh 

•H  U 

u 

•H 

*r« 

U H 

ft 

•H 

■H  O 

tft  B B 

P 

ft  -H 

•H 

u 

B 

(/) 

m 

O ft 

0, 

U 

ft  ft 

id 

O 0 

•H 

0)  <4H  (ft 

0) 

U 

i ^ 

a» 

ft  Ul 

• 

<D 

a>  q.  a,  u u 

G 

► -H 

•H 

► 

a' 

to 

to 

u 

o,-h 

0) 

> 

> 1 

i 

1 1 

•H 

• ft 

u 

1 

p 

i 

01 

1 

• « 

>1  >,  U) 

1 

fl>  a> 

<p 

i 

►4 

>j 

10 

>1 

B 

a o 

rH 

<«  ft 

O' 

B > 

> 

■ 

O' 

«< 

h: 

•v 

■ *n 

o 

U 

U -H 

44 

ft  3 

c 

•H  | 

1 

•H 

G 

V* 

U 

a>  u 

rH 

o 

O 4J 

3 

* O 

H 

ft  Ul 

P 

• ri 

•a. 

id 

t <d 

0,tft 

Uh  <0 

O 

w 43 

4** 

• n 

b 

1 

P 

1 

>5 

U 

>H  u 

0 

1 

l t; 

jn 

<A  1 

<d  rH  «H 

•r4 

rH 

Id 

« 

H 1 

a> 

04 

Oh-H 

i 

O rH 

u 

nj  ft 

p 

id 

u 

O 

r? 

<1) 

14  0) 

i 

m 

a fl 

4J 

14  10 

1 

3 1 

1 

3 

1 

y t 

o 

*4 

e 

S?  « 

* 

<D 

0)  u 

•H 

CP  44  .ft 

ft  Tl 

*o 

P 

xz 

O 

•H 

O H 

4> 

1 

• <1> 

G 

1 o 

o 

u v 

p 

0 

o 

•< 

u 

4J 

,d  4-» 

c4 

a 

to  w 

•H 

43  ft 

i-i  nj  ui 

to 

id 

•n 

v. 

*r 

>H 

u 

T- 

ih  rn 

in 

vo  r- 

a) 

CP  O 

i*0 

m 

o 

l~4 

o 

o 

*— 

c- 

r*  r* 

r- 

T* 

r- 

Oh 

X 

Ui 

► 4 

>H 

*1/ 

a* 

V» 

rH 

u 

1 i 

<D 

rH 

u 

*C 

in 

o 

in 

O 

U 

1 

tc 

•H 

• 

to 

« 

o ^ 

M 

14 

05 

o 

*0 

i> 

t2 

rH 

G 

>s 

*r  0) 

.4 

P 

*tJ 

.u  o 

o 

H 

*tJ 

a> 

•a. 

r~* 

10 

1 

rH 

fe.  -H 

V. 

O 

m 

*0 

Z?  *H 

u 

• t 

rH 

r: 

>: 

to 

(A) 

a* 

l • 

*c 

o 

U 

a*  -u 

1-4 

tj  M 

i •« 

\ 4 

MM 

t*4 

|H  1 • 

1 « 

fn  1 4 

l ♦ 

l« 

44 

'*• 

rH 

*4  4-* 

n 

Ui 

ui 

Ui  5/". 

U5 

V.  '43 

SMS 

’-5  X 

ri 

X 

X 

>4 

u. 

V) 

in 

M 14 

1*4 

* • 4 

M M 

M 

I't  <o 

10 

10  U4 

ru 

t*t 

1*1 

1-1 

4» 

c 

o 

> > 

> 

> 

> > 

> 

> > 

> 

>•  > 

> 

> 

> 

10 

u 

X ri 

o 

14  * • 1 

14 

>1 

.<1  M 

ul 

•g  g 

o 

10  to 

to 

ill 

iO 

P 

1) 

0) 

•H 

•H 

a 

•r*> 

A 4 i< 

o> 

c: 

m 

c< 

♦ > H 

(4 

4-' 

a 

•ri 

G 

O 

!d  <n 

*> 

4* 

4 ' 

4' 

3 

•H 

14 

» 

H c 

•H 

•H 

•H 

•H  ♦' 

•3 

G 

a> 

rT 

P • 

1! 

t:  *4 

C! 

C *H 

1/ 

p 

p 

•rt 

4‘ 

G 

o a 

t-J 

a»  -G 

•H  “H 

•H 

•*4 

•H  G 

U 

•H 

H 

• 

i 

•H 

Q.  «J> 

.c  u 

t c: 

1 

1 

1 H 

O 

G 

G 

G 

«0 

n .c 

4J  m 

cn-H 

n> 

C 

a | 

ft 

•H 

p 

O 

O 

0 

•H  4-* 

rH 

c:  i 

U 

o 

O CP  ♦> 

ft, 

I 

• 

•H 

•ri 

a; 

1 ■ 1 

rH 

«44 

•ri  t^*H 

•H 

H ft 

1 

4J 

G 

G 

4> 

P 

u ^ 

c o 

o 

o o 

>0  ft 

Ul 

44 

ft  *H 

a 

Ul-  -ft 

•H 

O 

O 

id 

m 

o 

♦4 

U)  -H 

Ul 

<d 

<0  Ul 

•H 

U ft 

G 

•ri 

•H 

U 

u 

4 H 

> 

0) 

f/1 

0)  Ul 

a> 

u 

U Ul 

1 

<U  -ft 

•H 

4J 

P 

•H 

•ri 

>• 

•h  *r» 

ll 

»rj 

U Ul 

u 

•H 

•h  a> 

cpj:  i 

1 

id 

m 

«p 

IM 

L 

m 

0» 

IO 

tu  D 

tft  o a> 

O 'ft 

<♦4  u 

G 

O n 

(X 

O 

u 

•H 

•H 

tl 

4-» 

o i: 

T3 

ft  U 

ft 

•H 

H O 

•H 

><  B 

Gi 

*•  »H 

•H 

U 

u 

H 

n« 

0)  IU 

in 

r-i  ^ 

m 

Q,  O 

a, 

14 

ft  ft 

4-4 

/d  o 

O 

•H  *n 

«4J 

u 

u; 

V 

i*l  . 

n rH 

<u 

O *r« 

O' 

1 ft 

i 

O'  a.  in 

o,  u 

U 

G H 

•ri 

> 

> 

1 

a 

♦ » o; 

n • 

U V) 

14 

ft.  Q, 

a 

> 

> • 

•H 

i i 

• 

•H  14 

14 

1 

1 

*t< 

Ml 

M 

(0  U) 

10 

1 

H 1 

a. 

1 

l ft 

rH 

>.  >,  in 

1 <1> 

a> 

4) 

0) 

1> 

o 

0) 

ft  '41 

'tl 

10 

a>  a*  >h  a 

r o 

1 

rH  id 

14 

O'  > 

> 

n 

■ 

-VH 

ui  on  oi  on  on 

M 1/1  lO  (Jl  « 


a cp 
u u 

fl)  -H  CP 

V 11}  C 
• Ul  H 
O'*  Id 

ft  u m 
•<H  O <11 
U]  ft  U 
w a.  o 
a>  i ft 
u a>  a. 

0 a/  * 

ft  ►,  0) 

n,  o a 

| H I ^ 
Oft.'' 
a m f* 
•h  a>  ft- 
u i c 
a>  ri  a> 
ft  a>  i 

ft.-H  >, 

1 W -H 

4j  « ft 

CP  rH  3 

iO  ro  O 

I l/l  a. 


cp  3-  in 
« i:  ui 
•H  H D 
'0  ft  O 
VI  10  o 
a u<  ft 
u 0 c. 
o o i 
ft  u ft, 
o an 
• i a 
« a,  • 
a a-  f' 

•r  I >.  ft 
H OH 
Cl’  rH  ft 
l,  ft,  nj 

0 P ft 

1 ill-n 

k > n 

vp  » u 
m a>  c> 
» a *j 


(<l  Ul  0)  O. 
01  U 1 (/)  </; 


M O ft  ft  H 

0/H  O O*/ 
) 0u»4H  ft  ro 

O'  H | I ft 

rH  d)  ft,  ft,  -H 

ft  i m m r 

s » a>  a>  ft 

o ai  i i a> 

S3  a Ul  J3  ft 


-h  rn  ft 

ft  ft  3 

m <o  o 

o t>  .c 

•H  I , 

P d’  ft 
ft  B >H 

qi  -h  a 


ft,  3 ft  | | 

l o -h  a>  u> 

',1  si  ft  B * 
(ft  | 10  *H  *H 

0 rH  ft  ft  ft 
ft  id  I I I 
cp  ft  .a  to  t3 

1 o o ft  ft 

43  ft  T'  tfl  U1 


fl  CP 
ft  ft 
111  - r 1 CP 

in  ft 

i w -H 

cr  a’  <n 
ft  u n 
■H  O lu- 
ll ft  u 
ui  n.  o 
m | ft 
U <!•  O 

0 V I 
ft  >•  0) 
ao  oi 

| rH  O- 

B o O 

3 H rH 

<-h  p a. 

H I K 

Hi  41  , 
ft  0)  | 

a ,h  sh 

1 ft  rH 

n <o  ft 

PT>rH  3 

(0  (0  O 
» ui  a 


r <N  n .1  id  lO  P 11  ^ O P N "1  O in  'll  P-  P 1"  ">  •*  <N 

rrrr-rr-rrrrlNiNN 


wv  uiuwfiv  1 1 ulw  m juejph  ■ "urrr 


o 

wi 

hi  in 

0) 

to 

io  to 

i/I 

to 

Ui 

r* 

Vi 

HI  10 

<o 

10 

to  to 

U) 

to 

VI 

lO 

to  to  to  m 

to  to 

to 

to 

to 

u 

<J  o 

u 

u 

o u 

U 

u 

u 

o 

o o 

o 

o 

o o 

O 

o 

o 

IM 

u<  ih  at 

*o 

lit  IV 

111 

tU 

<\* 

<x  n» 

tv 

a. 

Ol  (Vi 

IX 

04 

to 

o 

•< 

04 

u 

o 

(4 

■H 

o 

P 

■H 

f 

t3 

a 

a 

♦ > 

P 

u 

o 

o 

o 

O 

3 

o 

H 

T5 

H 

3 

X 

h a 

4i 

♦J 

O') 

P 

O 

a 

P 0 

«d 

•TJ 

M 

If 

O a 

o 

If  .p 

o 

•—4 

ro 

V 

M O 

o 

p p 

•H 

O 

O 

3 

a <H 

1 

3 if 

u 

• • 

a. 

i p 

10 

Q.  U 

•H 

CM 

N 

m m 

a 

c 

It  P 

14 

<n 

T* 

O 

V P 

o 

o 

O tp 

a' 

O 

u 

V 3 

•H 

p 

O H 

N 

f 

lO 

1 

-a  n. 

P 

p 

1 P 

1 

M 

r* 

M 

in 

u « 

if 

u 

t*.  n» 

d' 

3 

r- 

»: 

u 

►-  a 

P 

3 

If  ► 

■ 

0>-H 

o> 

3 

if  u 

3 

X) 

n,  i 

•H 

a 

« 

vr* 

/, 

O 

a.  t 

a. 

O' 

i tf 

4* 

•r4 

4« 

Jii 

i >-  m 

•o 

til  n 

• 

u 

% 

\A 

1 

N.  if 

o 

1 

tn 

rH 

o 

sO 

91 

i~i 

*-t  a. 

u 

o ♦ 

1 0 

M 

• 

r— 

r* 

if 

il  1 

1 

if 

o » 

»4 

i 

tl) 

i 4 

P 

3 P 

H 

» 1 

OMf 

4> 

a 

tr 

04 

O 

O 

o a’ 

ITS 

o 

1 P 

u 

o 

« 

nl 

U 

P 

a c 

+4 

p 

•U  (0 

*s 

»r> 

r» 

0) 

<•1 

•j  m 

r 

o l»> 

x N 

r— 

CM 

*0 

•0  >0 

"4 

i * 

M 'M  *M 

«n 

tO 

♦J 

u 

O 

04 

a> 

• Vi 

o 

to 

»n 

•H 

1 

10 

IO 

>4 

IS 

rH 

» 

* 

4« 

M 

•a 

Is 

O 

•H 

HI 

01  l/> 

0) 

01 

M Ol 

0) 

io 

</) 

1/) 

91 

Cl 

(0  O) 

M 

Ol 

0)  l J 

U] 

i/) 

ut 

01 

iT3 

10 

in  to 

lO 

to 

1*1  IO 

0 

iO 

VO 

tv) 

t: 

u 

u u 

U 

u 

L»  U 

C ) 

vi 

U 

u 

o 

o o 

o 

o 

O O 

a 

O 

C 

O 

i4 

l>< 

>i.  in 

Ml 

III 

it«  is 

Hi 

ti* 

l»4 

U4 

111 

n.  n< 

1 M 

111 

IW  tv* 

lo 

u« 

1^4 

Oi 

fi 

•H 

o 

4* 

•H 

ffl 

(3 

t« 

i‘4 

*» 

1 J 

p rn 

O 

o 

O 

U 

D 

o o 

r4 

*»-4 

T— 

•»-4 

3 

U 

H .1 

i3 

4» 

1 » 

III 

♦> 

TS 

n 

*1  10 

O 

•n 

•n 

n 

o 

If  M 

ri 

o 

r-4 

• 

4^' 

VI 

o 

o 

♦ • D 

♦ ' 

•r4 

3 

m 

n 

i 

3 U 

IT 

V4o 

O 

a 

t 

id 

4» 

>1  O 

U 

•r4 

rH 

»» 

m 

u 

*3 

«v 

».  o 

»r4 

14 

tT< 

O 

o 

U 

o 

O 

4' 

O Cl. 

V4.4 

u 

) 4 

o 

d’ 

H 

H 

3 

u » 

•r  4 

> 

t 

VI 

1 

al 

4/ 

4» 

a* 

t rt 

14 

1 

n 

Hi 

U) 

U 

U 

•VJ 

M 

>•  3 

d> 

3 

S) 

14 

>*• 

3 

1 1 

O 

if  *H 

s 

« 

> 

10 

3 

rtl 

T3 

ri 

o 

a.  n 

1 

»»  1 

f3  « 

.v| 

o 

n« 

vl» 

ill 

1 

« a> 

vl' 

4 

H 

.u 

4 

tJ 

11 

.SI/1  ll 

n 

1 

4»  U 

IS 

•*: 

1 

>, 

t 

O 

<r» 

tr  o. 

r-4 

<tv  O. 

n 

Sr* 

rH 

rH 

o 

u.  o I 

4 1 

<n 

14  • 

14 

(Tl 

t 

1 

u a> 

• 

l a’ 

:% 

3 

4J 

N 

*•» 

tr  tr  t.i 

4> 

A r» 

o 

o 

O 

o 

r 

ai 

» tt 

4> 

O 

O »r* 

is 

a 

4^ 

4» 

CJ 

x 

4d 

to 

•r*'  .» 

» 


1 5 

n 

•:1 

* 


l 


! 


to  VO  ‘O  »t\  •>  r-  fN  rn 
fMcs»rs|fMfNrMiN|fnmm»^ 


in 

r- 


U) 

o 


tv 


JO 

m 


m 

o 


IN 


r> 

e'- 

en 


tv 

«/> 


n o 

<N  X 

«N  CO 

n r» 

>N  4> 


♦ M M M M M ♦ M M M H H ♦ MM  MMM  4 MHMHH  4 MMMMM  4 


IN  in 

in  cr 
IN  rn 
<N  *N 

<N  f“ 


♦ M 


♦ M 


«N  O 


H 4 M M M H 4 4 M M >4  M > 4 4 M >4  M M M 4 


« 


X 

M M HI  M 


♦ H M M M M 4 M H H H M ♦ 


15  X 
M X 


w 

1 

1 

1 

M 

I 

| 

i 

O 

r- 

1 

1 

1 

a. 

I 

f 

1 

at 

1 

• 

1 

a; 

T—  VO 

( 

i 

1 

o 

10 

1 

1 

1 

1 

1 

1 

ro 

•H 

♦ MM* 

» M M ♦ 

MMMMM* 

mm 

1 

10 

r-  m 

1 

1 

1 

m 

» 

1 

1 

a. 

M 

» 

• 

; 

o 

•0 

f-  ct 

* 

• 

i 

15 

R 

1 

9 

M 

X 

I 

| 

s 

u* 

r-  «') 

| 

l 

; 

IN 

U 

1 

• 

i 

M 

■H 

1 

t 

i 

<1 

r-  iM 

1 

1 

* 

IN 

■0 

I 

I 

i 

t ) 

C 

| 

1 

i 

r*  r* 

t 

| 

t 

X 

Q 

1 

• 

i 

1 

♦ 

l i 

M 1 ( 

1 4 

» 4 

• 

♦ 

Mil 

» 4 

» 4 

I 4 

i 

♦ 

Ml4  4 

1 4 

1 4 

i 

4 

MM 

I 4 

MM 

• 

4 

l—  o 

1 

1 

l 

9 

i 

i 

X 

i 

1 

• 

t 

O' 

• 

1 

1 

i 

m 

X 

• 

• 

1 

» 

• 

• 

1 

• 

n 

i 

1 

1 

1 

1 

I 

• 

• 

1 

X 

i 

i 

i 

1 

• 

• 

1 

• 

9 

X 

r* 

• 

1 

1 

1 

X 

• 

i 

1 

4 

1 

4 

Pi 

M 

1 

1 

i 

• 

1 

rn 

4ii 

1 

1 

i 

% 

1 

• 

M 

VI' 

I 

O 

X 

1 

i 

i 

• 

«n 

*< 

I 

1 

i 

i 

1 

1 

1 

i 

i 

• 

♦ 

M 

M M 

* 1 

H 

♦ 

M M 

M 

M 

» 4 

4 

MMM 

* 1 

* 1 

♦ 

MM 

M 

14  » < 

4 

O 

to 

in 

I 

n 

1 

X 

1 

i 

1 

M 

► 1 

1 

1 

1 

9 

t 

to 

10 

1 

• 

1 

9 

1 

lU 

X 

si 

I 

X 

1 

1 

4 

O. 

1 

m 

M 

t 

• 

1 

9 

9 

> 

•« 

I 

1 

1 

9 

1 

1 

• 

X 

1 

4 

r»> 

1 

-< 

-< 

1 

1 

1 

U 

1 

»o 

1 

1 

t 

i 

9 

U 

i a 

M 

1 

n 

X 

1 

1 

i 

O 

9 

• 

>; 

1 

9 

1 

1 

1 

1 

i 

9 

■ 

• 

• < 

r— 

1 

X 

1 

1 

9 

U« 

i 

35 

1 

1 

1 

9 

i 

X 

1 

1 

t 

1 

i 

n 

♦ 

1 -4 

W t l 

M 

M 

♦ 

T 

T 

M 

> 1 

1 -4 

♦ 

MMM 

M 

* 4 

4 

4 4 M 

M 

M * 4 

♦ 

T~ 

CN  <">l 

sr 

in 

6 

7 

<D 

CT> 

o 

l-  cm  m 

-t 

in 

no 

O'  O 

T* 

T-  V-  »- 

r- 

r-  r- 

r-  iM 

MMMMM 
iN  n 
U X 


♦ *-l  M M I l M * 


X 


X 


MMMMM 

X 


O X 


'4  H 


O 


u 


♦ MMMMM  ♦ 


I M M M M I 


rv 


M M M I M I 4 


MMMMM  4 


f(Nm 
(N  IN  <N 


1 in 

s|  »N 


V44 


f 


w 

• 0 

U 

IX 

c 

0) 

l/i 

il> 

IX 

o 

in 

t*l 

> 

(0 

• H 

u 

•r-4 

4J 

O 

o 

% 

cr  in 

♦r~4 

H 

IX 

1 4 

UJ 

'Tl 

3 

IX 

4i 

0’ 

M 

a» 

«.' 

C 

O 

d 

• 4 

d 

M 

o 

u 

u. 

> 

44 

*-4 

4 * 

o 

U 

• 

IU 

.0 

► 4 

a. 

X* 

o> 

*44 

• 

a> 

r: 

44 

<f 

1 4 

% 

IX 

J— » 

•r-4 

in 

i>< 

h 

<f 

.v3 

X’ 

n 

in 

m 

hj 

G 

44 

V. 

Ol 

O 

01 

IM 

o 

t/> 

+> 

X 

• 1 

*1 

o 

c* 

u 

fi 

•H 

<r. 

• 

vJ 

1 4 

44 

4* 

o 

1 

tfl 

0) 

0) 

g 

* 

IX 

c: 

IX 

IX 

5m 

o 

4J 

o 

o 

n 

il« 

1 * 

Cl 

•H 

IX 

u« 

rl 

<f 

H 

r-4 

t\» 

0> 

M 

£2 

•f 

G 

o 

4> 

u 

3 

V^. 

H 

d 

wX 

M 

1* 

g 

fl’ 

•r4 

H* 

XI 

i < j 

O 

IX 

:* 

a> 

1 < 

•a. 

3 

M 

H* 

»4 

HI 

cn 

U. 

3i 

G 

G 

•V 

1-4 

l 

a: 

u* 

• 

•r  4 

4 • 

U 

•M 

•r4 

a 

>-l 

M 

14 

*v 

O 

•H 

>•* 

in 

44 

1 4 

IJ 

v* 

O’ 

r~ 

G 

fc 

r-4 

>5 

u 

it* 

IJ 

4 ' 

if 

HJ 

c 

H 

4-» 

O’ 

CD 

o 

*i;  v-* 

h 4 

c 

• 

G 

o 

•H 

-c 

in 

u 

O 

1 • 

••-4 

O 

>- 

tr* 

a; 

it, 

>-•  4H 

1 4 

ll 

a i 

C3 

•m 

HJ 

*h 

u 

*n 

1*4 

J)  l 1 

4-4 

a, 

V 

o 

r-4 

g* 

U 

M 

U 

Cl 

u 

in 

X 

n 

v 4 

(0 

rl 

in 

c: 

O’ 

to 

Ml 

1 » 

l»l  v. 

l) 

' r-4 

4> 

H 

u 

•H 

H 

M« 

CD 

ix  O 

<0 

N 

14 

o> 

-M 

i-l 

rx 

:*\  u 

U 

C'J 

O 

» 4 

a. 

c 

in 

* *> 

o 

G 

• -4 

>- 

•u 

6 

1 4 

v!>  ix 

• 

• 

*P 

44 

0» 

O' 

1 4 

♦ 4 O 

1-4 

O 

03 

:o 

u 

o 

x 

<f 

M» 

% 

IX 

!*• 

•H 

«f 

c 

4J 

in 

\ 1 

1 * 

I'M 

n i 

11 

41 

*n 

xs 

CD 

v* 

O 

o 

r- 

in 

o 

x 

<u 

1 4 

M 

1 1 IX 

1 4 

H 

% 

Ll 

IX 

a< 

v 

3 

o 

O 

> 

o 

4' 

44 

rO 

tr 

Xi 

«1 

V.  4 4 

% 

u 

O 

• 

«f 

V* 

in 

I' 

o 

a» 

to 

rn 

W 

Q) 

% 

• 

in 

• • 

• • 

G 

*4-1 

H 

*0 

tl 

r> 

to 

V 

r- 

fO 

r>^j 

if 

in 

0) 

l* 

G 

fl 

jx 

> 

HI 

o> 

O 

M 

0 

o 

4) 

x 

• 

• 

rn 

•H 

in 

M 

m 

• 

U 

*— t 

O 

o 

o 

Cl 

•H 

10 

>« 

u 

T* 

> 

.r. 

•41 

•,* 

% 

•H 

cx 

f-4 

•H 

0> 

o 

O 

in 

u 

to 

M 

•< 

G 

u 

U) 

u 

U 

u 

tn 

0) 

10 

in 

t* 

in 

a* 

•H 

a. 

cr 

•H 

•H 

M 

Jl 

•H 

♦n 

< 

o 

> 

g 

l 1 

44 

u 

44 

u 

u 

o 

*-M-t 

*•  i 

in 

01 

o 

U 

o 

U* 

m 

CT 

u 

a 

HJ 

c: 

o 

o 

*»» 

% 

vP 

IX 

r> 

u 

if 

tn 

•H 

*»-4 

hi 

cl 

r: 

(X 

tn 

4> 

ex 

\ i 

•r-« 

•H 

4* 

O' 

r* 

tn 

O' 

Ju 

•V 

*T? 

♦ » 

a 

n 

if 

o 

in 

B 

4l 

< 

0> 

a> 

H 

H 

t: 

U 

If 

0' 

V. 

01 

0J 

m 

44 

<v 

o 

(.1 

o 

14 

> 

!m 

d 

u 

o 

O 

x 

<4-1 

if 

•H 

O 

M 

HJ 

to 

cx 

1 4 

9 

9 

M 

a* 

ex 

rf 

I 

I 


II  14 


;•> 

% 

o 

% 

; •, 

1 1 

01 

1 » 

rt* 

O 

M.  |«) 

• » 

:i: 

V* 

ll  01 

a 

l»; 

u 

Ml 

.4 

-.-4 

-G 

> 

1-1 

W 

Ml 

O 

• 0 

♦ > 

<•4 

o 

.1 

o 

IX 

1 4 IX 

.0 

il 

ll 

l 

; 

• X 

0 

*44 

a? 

G 

1 1 

*k 

i 4 

u 

t ♦ it 

u 

1 1 

.n 

*f 

tf; 

l > 

t-3 

u 

o 

t) 

4 * 

• 4 

in 

»X 

u 

4J 

14 

• 

o 

Ul 

t 

O . 1 

.1 

T? 

G 

m 

c 

1 

»** 

i 

>• 

L.  £3 

P 

•f 

i/) 

IT 

I I 

o 

n 

o 

III 

u 

44 

• 2 

H1 

•: 

n » i 

•it 

G 

'0 

-4. 

to 

i i 

G 

•H 

X 

« D 

; ; 

> > 

o m 

4^ 

u 

» 1 

i 

**» 

I 

♦ 4 

O 

• 4 

ti  t*i 

to 

Cl 

.X 

-C 

ti 

i 

l 

u • 

I i 

*1 

•3 

", 

o 

u 

in  .•* 

U 

i • *< 

1 4 

I i 

» 1 

*1 

1 

•< 

iu  o 

> 

0. 

•#4 

>1 

t * 

.X 

1 i 

l'4 

l»l 

>> 

»»* 

•1. 

44 

>• 

O 1 >i 

>• 

> IJ 

lx 

l“ 

u 

w 

V. 

j| 

V. 

G 1 l 

•*; 

t*.  o 

l> 

.V3 

*H 

1 « 

* < 

i. 

•J. 

in 

*k 

t.* 

4 

• . 

vi* 

a v. 

G * 

ill 

O' 

10 

Cl 

iX 

.Cl 

u < > 

M 

«V  *0 

IX 

o 

0 

•ij 

4 • 

t <i 

1 1 

,fl  u 

1 I 

> »i) 

G 

l * 

I 

•4 

'l 

•H  it) 

• 

il* 

*-4 

O' 

% 

II 

uj  t: 

» 1 

•J'  o 

m 

M 

c 4 

■f 

l 1 

il 

C. 

1 » 

u af 

» < 

f ■ > 

oi 

a: 

r-4 

r4 

« t 

O 

) 

\ 

4 4 

0'  > 

1 4 

•1  M, 

i*i 

t 1 

G 

*11 

t\ 

1 i 

u.:  •»< 

*\ 

.Cl  ill 

u 

«x 

•M 

1 J 

Ml 

1 « 

i < 

4-*  r- 

1 4 

4 ‘ 

o 

in 

i . 

fil 

i 1 

.1* 

l«. 

« 4 

• * 

« * i 

n 

* ^ 

] 

l * 

il  H1 

» • 

G x. 

4* 

o 

G 

n 

; 

. \ 

o 

O-' 

O 

v*»  *f 

o 

il 

4 • 

i ♦ 

•*. 

o 

.1 

ai  u 

m \ 

.il 

>, 

V *. 

#*, 

o 

o 

» o 

^ in 

c: 

ll 

ll 

i i 

t 

, f 

01 

*♦1 

M 

i i 

if 

in 

i' 

♦1 

«f 

J 

HI 

*n 

Ml 

*\  * M 

*«  i 

o 

il 

v 

.) 

C> 

vl'  to 

O 

O'  .t 

cn 

o 

Hi 

4 ' 

0 

1 1 

*»  , 

9 

n 

*>  It 

*1 

1 ' r* 

M 

1 4 

X 

< 

/) 

d l/l 

c:  i i 

in 

to 

% 

.*1 

Cl. 

il 

•• 

*r4  3 

• * 

'rA  :• : 

• ► 

in 

to 

i* 

*1 

14  Hi 

t 

II  iX 

*k 

li  1 

> 

1 

♦ r* 

u 

lx 

9 

a*r-4 

exm 

u 

u 

G 

i 4 

• 

u 

• 

t 

• 

« ) 

•1' 

»i « 

l 4 

14 

o 

n 

n 

to 

n 

O 

IX 

> 

1 4 

o 

[M 

*r4  1%; 

•r4  t< 

o 

; •, 

iX 

0 

to 

in 

c 

' i 

!•» 

Ml 

u 

a'  .4 

o 

% 

o 

cl 

'li 

m 

•rl 

CD 

1 

•<-9 

r"  -< 

•X 

*r*  ^ 

VI 

•H 

o 

o 

.*» 

1 

44 

if  t». 

1 

HS  1*1 

o 

4J 

1* 

u 

14 

M 

M 

i * 

t.0 

tl  t ' 

1 1 

to 

•*  4 

o 

O 

in  t" 

o 

to  o, 

1 * 

o 

* »» 

* * * 

• n 

• 

c: 

O'  •-*. 

G 

O'  -* 

1 4 

C 

u 

»X 

m 

Ml 

-rl 

r»  i i 

M ii« 

o 

V 

G 

in 

N 

*1* 

HI 

> • 

«f 

IX 

•1 

Hi 

XI 

*C‘ 

G 

;*l 

• v 

K 

r-4 

to  o 

r-l 

'0  t.t 

a 

•H 

4t 

u 

N* 

Cl 

ID 

.,1  IJ 

o 

'M  1 4 

u 

(4 

c* 

> 

o 

*« 

,v!  ft 

.C  *r1 

*C-4 

a. 

•r| 

IX 

Cl 

•* 

i 

1 I ill 

1 

MH 

HI 

i 

1 4 

to 

t*>  Hi 

o 

.X 

r- 

r- 


o 

•< 

Cu 


*0 

•n 


»N 


r- 

O' 


c- 


O# 

Ml 

CO 


o 

f*« 


U 


iJ 

V4 

0/ 

o 

U *■ 

a. 

•r-(  Ifl 

u> 

i*. 

6 H 

m ■ ’J) 

*N| 

C 1 

(34 

>1  o 

*n 

•»o 

Ml 

'O  u 

C/) 

1 

to 

l • 

•0 

to 

CO 

'l>  H 

1*4 

1 -* 

• « 

U 

itl 

•/) 

•o 

o 

6 

c 

U <XJ 

n« 

• -i 

*a 

CJ 

<0 

ilt 

u 

u.  a 

O 

w 

a>  x: 

»C 

•*•1 

M 

</; 

G 

B 

IXJ 

<r 

>~ 

O 05 

u 

4-i 

» B 

i\| 

l-l 

a. 

to 

£ *H 

to 

• c 

•H  XJ 

to 

;♦; 

t < 

til 

rc. 

W 

u 

5" 

4 * • 

o 

>* 

03  U 

{)( 

n 

•H  -C 

a, 

tO 

O 4’ 

o • 

:ti 

•H  O 

t . »“ 

4* 

4.1  ’W 

4 — 

>* 

u .c 

o 

It 

*< 

<o  u 

4J>  M 

' •> 

> • 

O 'XJ 

M -* 

• 

D 

Il«  Ml 

1*1 

• • 

c 

C«  > 

o 

<l>  i3 

•1 

«*. 

to 

> V 

t— 

O 

1 ^ 

• 

H *r| 

hi  tO 

• i 

0 

O 

rr>  » 

til 

w/j 

>< 

V . 

H CO 

n» 

►O 

oj  to 

v*, 

to 

< 

o 

D a. 

M •< 

> 

Vi 

•r*4 

fi  *H 

> 'J 

• ». 

<XJ  -C 

Ml  l_ 

• t 

to 

i.:  to 

ii. 

tO 

O 

. o 

ZD 

U 

n 

o o 

'V  M 

i I 

c* 

31  H 

t-1 

;•  J 

ai 

4»  ♦ ' 

(X  U4 

•4 

•H 

<XJ 

B il 

uv 

a 

0>  H 

m u 

>« 

X2  vi’ 

X .A 

• 

l«  u 

U M 

*« 

ao 

tD 

r* 

a 

►*5 

M 

H H 

N M j)  W 

^ v; 

% 

o o u u 

10  0 

H 

.•i  as  as  as 

r 4 * 4 

40 

w t*J  w 

t/)  to 

O 

UI 

Ui  U)  U.  III 

• 4 M 

> 

a.  u<  iii  n. 

l/J  to 

CVi 

►*4 

3 0 3 3 

o u u u 

O O 

% 

u u u u 

tj  O 

to 

o o o o 

U-4  K 

M *4 

.0 

4 !£  *4  riS 

< J 

o o o o 

>«  >h 

00 

a 

4 -1 

u*> 

14 

4 4 4 4 

0 »0 

• • 

CV4 

O O O O 

• C 

M M M Hi  O IT  t?  19 

O O 

O 

*< 

h l<  h H as  v.  as  a. 

► 4 » 1 

•• 

UU  UUHHHH 

u r 

CN 

►* 

< < < «<  w tn  to  to 

cr. 

in  t/>  i/i  to 

u.'i  ir. 

>-  X >1  >H  t%!  1*1  111  1*1 

>-  v* 

o 

4 a.  /.  » u u u u 

O Ci 

N 

><-<<<«;oooo 

h 

►-4 

i*4  fii  ir.  ii, 

1 4 hi 

a> 

H 

r*4  w w »*i  :u  a.  rs.  a. 

ui  ao 

r- 

o 

i-«  n H l • 

lid 

**.  *<  Vi.  +X.  u.  U<  III  »J. 

>►  >, 

% 

tu  O 

1 • M M M hi  hi  »vl  i.j 

-r  < 

O M 

H h t « h x £ -C  A 

r“ 

1 « 

H H H H IM1'  h l« 

n » t 

V.  « iT.  -5  U«  i*«  »*«  i». 

CL 

C 0 

mhh  nc  d s d 

to 

iX,  ^ 

lt4  U4  1X.U, 

to 

k o 

r • f < f * [ « 

J 

:>  O 0 0 0 0 0 O 

w ^ 4*  *•*  -a  ui 

o »*♦ 

u; 

u» 

:•«  o 

l u 1 ‘/i  0 0 uj  01  :n 

• 4 

u 

O I14  h-i  hi  hi  to  UI  ui 

10  rn 

a 

00000000 

to  ^ 

tu 

cr 

fl  U Q U U U l ) U> 

a *h 

a> 

t <1 

u v: 

a 

4.  «4  ^11^  1 *^.  ^ 1^  4,  ^ 

0 w 

m v4>  at  1 10  in  ii>  h- 

iD 

C- 

V) 

-*« 

*-  1 >»  l >1  C>J  l'* 

a,  u 

■H 

ij 

» 0 

• 

w 

lz> 

U 14 

w 

:►» 

-J 

tt  3 j 3t  r«  ;«  ;*  .« 

a>  u. 

i c» 

rH 

0 0 O 0 0 0 0 0 

. 

n 

0 

J 

.1;  it;  til  1 r«  ti  n«  114  i!« 

0 fa 

o 

C 

w *■-—  W w-  w 

r-H  3 

M 

**. 

U.-r-1 

U-. 

ta  Q 

u 

— *. 

4^-. » ai- 

i a- 

•H 

i/j 

to  04  to  to 

1 to 

fa 

01 

^ ^ _ in  u)  v)  U) 

>-  u. 

UI 

H H 1 * H 1*1  10  M (v* 

^ t 

Ui 

u 

^ -5  n u.  u 0 U 0 

I*  a 

o 

ro  10  ui  to  <u  0 0 0 

d tr* 

IU 

> > > > a,  .i,  u<  »*4 

0 <n 

u» 

*1  O ’O  1*4  O*  fu  U«  iX 

^ » 

W W "W  ' W W 

to 

1 

; • 

.0 

1 

* »; 

► r 

0 

1 

!> 

4 ' 

«*. 

1 

0j 

1 

•H 

•H 

O 

f0 

1 u 

UI 

1 

C 

e 

•H 

tr 

f/i 

1 O 

0 

1 

•*-4 

•r4 

u 

* 

► « 

UI 

| 'H 

•< 

1 

t 

1 

a* 

(T 

•ri 

T— 

x: 

, V 

t/J 

1 

U 

« 

L> 

u 

tl 

«U 

1 O 

r/) 

1 

O 

O 

• 

0 

O 

to 

1 

to 

»o 

'0 

1 3 

0 

1 

H 

► 4 

H 

il 

•H 

i^4 

u» 

1 

it) 

• 

0 

1 *f 

>: 

• 

*J 

♦ * 

Cl 

O 

u* 

Q 

0 

1 

0 

(*4 

1 O 

• 

V 

•H 

•H 

IT^ 

U 

U 

«4 

1 

0 

1 u 

O) 

1 

U 

U 

1 

U 

♦■» 

U 

O 

1 

1 

l 4 

4/1 

|V» 

1 ^ 

04 

• 

•H 

•H 

tr> 

rd 

J 

1 

*r  4 

hi 

1 

a. 

O 

1 1 

l » 

1 1 

i«: 

1 

W4 

a 

U 

a, 

•0 

♦ * 

to 

1 

S 

1 

> 1 

1/4 

to 

1 >' 

V. 

1 

•H 

•H 

•H 

•H 

R 

c 

iC 

i 

r»-* 

sV 

01 

>* 

► -» 

r 0 

u) 

■ 

U 

U 

♦ ’ 

‘UI 

O 

0 O 

♦ » 

> 

<r« 

J 

114 

»-4 

cu 

1 a 

H 

1 

V 

a» 

to 

•H 

U 

•H  *r4 

J 

>< 

1 

a* 

to 

*< 

> • 

1 •J0 

hi 

1 

> 

> 

H 

t-i 

1 

V>  u> 

n< 

r > 

1 

u 

O 

> 

ii^ 

0 

1 u 

►-1 

1 

• 

1 

H 

a 

to 

u w 

b 

4*4 

i 

» 

*— 4 

< 

0 

J ^ 

LU 

1 

B 

u 

> 

M 

3 -U 

0 

i*  4 

1 

01 

IU 

*< 

i* 

3 id 

I j 

1 

► 4 

M 

T3 

1 

3 

T*  — 

u 

1 4 

1 

rrj 

n 

ui 

in 

4-4 

| CL 

O 

1 

O 

O 

U 

u> 

O 

O'  cu 

f 

0 

1 

►11 

O 

1 1 

O 

1 

LM 

4.4 

(T 

R 

Xi 

B 

>. 

14 

1 

/rl 

1 

4 4 

i* 

I >■- 

ir. 

1 

U 

•**4 

1 

• O 

01 

1 

u 

> 

x; 

f 

1 4 

• 

1 

U’ 

r-4 

rH  U 

u. 

; •, 

1 

2 

—4 

< 

1 ^ 

1 

a 

a 

0) 

1 

IT 

in  l 

1 

O 

1 

41 

14 

*~4 

1 3 

1 

<D 

<v 

B 

T5 

U> 

*•>  X 

u» 

O 

1 

n 

r? 

>« 

O 

1 O 

O 

1 

1 

1 

•H 

u> 

O 

0 T5 

0/ 

*m < 

1 

•H 

O 

a 

O 

1 -C 

tr, 

1 

tO 

xt 

4*> 

tn 

♦ ■* 

X'  4’ 

c 

M 

1 

4^ 

.c 

II?  A User  ' Manual 


rXI'TNri  D P.IC7UFF  iEP0£2 


To  present  in  graphical  torma*-,  for  ouch  name  innut,  a 
of  names  related  to  it  by  structure  or  by  data  flow. 


net  work 


I n t o rroa  t j on  Presented 

Names  input  to  tin  import  may  have  any  of  the  followinq  types: 

FLEMFNT 

ENTITY 

iJPOUP 

INPUT 

IN7~FFACV' 

0 U T ° UT 

PFocrt's 

Sr>T 

Starting  with  each  input  name,  one  of  four  pictures  will  be 
obtained.  ITh-vn.-  are  interred  to  as  structure  downward, 
structure  upward,  data-flow  forward,  and  data-flow  backward. 

For  each  name  used  as  input,  the  report  presents  all  successors 
to  that  name,  where  successors  are  found  using  the  relationships 
listed  in  t he  appropriate  column  of  either  Table  3 or  Table  4. 
For  each  of  these  new  names,  the  report  presents  all  of  its 
successors,  finding  them  in  a similar  manner.  This  network 
continues  until  the  desired  number  of  relationships  has  been 
traced,  a loop  is  encountered,  or  nc  more  relationships  are 
found. 
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Sane  Ty pe 


Relationships 

Displayed 

Structure  Downward 


Relationships 
Displayed 
structure  Upward 


ELEMENT 

CONTAINED 

ENTITY 

CONSISTS 

CONTAINED 

GFC  UP 

CONSISTS 

CONTAINED 

INPUT 

SUBFAFTS 

CONSISTS 

PAFT 

CONTAINED 

INTERFACE 

SUBPAFTS 

PAFT 

OUTPUT 

SUBPAFTS 

CONSISTS 

PAFT 

CONTAINED 

PFCCESS 

SUBFAFTS 

UTILIZES 

PAFT 

UTILIZED 

SET 

SUBSETS 

CONSISTS 

SUBSET 

Table  1 

Structure  Relationships  Displayed  in 
Extended  Picture  Report 
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Naff-*  Typo 

F>*  1 1 1 i onsh  i ps 

Pi  > n 1 e y * 1 
niM*Flcw  F o r w a r .1 

Relation  -'.hi  ps 
Displayed 
Data-Flow  Pack w 

ELEMENT 

U5t.U 

USED  TO  DERIVE 

USED  TO  UPD  AT  F 

PEF IVED 

UPDATED 

ENTITY 

USED 

USED  TO  PFFIVE 

USED  TO  UPDATE 

DERIVED 

UPDATED 

O.FCMP 

’15  SP 

ll?E,i  TO  DSR  T Vp 

U S E P TO  D TO ATE 

PER  IVED 

UPT  AT'ED 

INPUT 

F FC  L I V F T 

USED 

1I5  EP  TO  PFF  I V r 

USEP  TO  11  PD  AT  v 

O.FNEFATFD 

IKTfSFACr. 

0,;-.'Nl.FA'"iS 

RKCFI VLS 

ourpir 

FLO  FI  VI P 

0.FNSFAT1D 

DEF IVED 

PROCESS 

O.LMF  S/.TLD 

DERIVES 
u pd  An:  5 

HF.CFIVES 

USES 

IISFS  TO  DEFIVE 
USES  TO  UPDATE 

51.1 

USED 

used  ti  dffivf 

USED  TO  UPDATE 

DLMVED 

UPT ATED 

Tablo  4 

Da*  a Flow  Folat  ionships  Displayed  in 
Extend* d Picture  Report 
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Fo  rmat 

Fach  name  which  appeaLS  on  the  output  is  shown  within  a box. 
The  top  line  of  the  box  indicates  tt*  name  type,  while  the 
bottom  line  shows  the  relationship  with  a name's  predecessor. 
Boxes  containing  related  names  are  linked  by  dotted  lines. 

If  a name  -joins  two  or  more  chains  (stt.ir.qs  of  related  names) 
into  a loop  or  loops,  every  appearance  of  that  name  after  the 
first  will  be  followed  by  the  message,  '•  NAME  OCCURS  1LSF.WHE5E. 
SEE  INDEX.". 


Output  is  continued  across  page  boundarits.  It  the  riqht  edqe 
of  one  paqe  continues  to  the  left  edqe  of  a second,  the  riqht 
most  column  of  boxes  on  the  first  naqe  will  be  repeated  as  the 
left  most  column  of  boxes  on  the  second  page,  in  order  to 
facilitate  matchinq  of  eiqes.  Similarly,  il  the  bottom  edqe  of 
one  page  continues  to  the  top  ertqe  of  a second,  the  bottom  row 
of  boxes  on  the  first  page  will  he  repeated  as  the  top  row  of 
boxes  on  the  second  page. 


Options  and  Alternatives 

The  report  may  be  generated  for  a single  name  (via  the  NAME 
parameter)  or  for  a collection  of  names,  either  input  by  the 
user  or  obtained  by  use  of  NAME-GEN . 

The  type  of  picture  fo  he  produced  is  selected  by  specifying  one 
of  the  followinq  parameter  pairs: 

STSUCTUPE  DOWNWARD 
STRUCTCPE  UPWARD 
DAT A- F10W  FORWARD 
DATA-FLOW  PACKWAFD 

or  by  specifying  the  THREAD  parameter,  in  which  case  the  pair 
DATA-FLOW  FORWARD  will  be  implied  but  limited  to  the  USFD  TO 
DERIVE  relationship. 


The  number  ot  columns  and  rows  used  on  the  page  may  be  decreased 
from  their  default  values  of  11°  and  19,  respecti vely , via  the 
COLUMNS  and  ROW?  parameters.  The  minimum  acceptable  values  for 
COLUMNS  and  ROWS  are  39  and  14,  respectively. 

The  number  of  boxes  arranqed  horizontally  or  vertically  on  a 
page  may  be  decreased  from  the  defaults,  which  are  the  maximum 
numbers  that  will  fit  in  each  direction  (depending  on  COLUMNS 
and  ROWS)  , in  order  *o  make  the  output  l5ss  cluttered.  The 
parameters  which  can  be  used  to  do  ♦■his  are  HORIZONTAL- BOXES  and 
VERTICAL- ROX ES . Their  maximum  values  (tor  C0LUMNS=119  and 
R0WS=3°)  are  6.  Due  to  ♦he  scheme  foi  continuing  pages,  theiL  • 
minimum  values  are  2. 
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The  number  of  connections  to  be  traced,  startinq  at  the  given 
name,  may  be  set  at  any  positive  value  via  the  LINKS  parameter 
The  same  LINKS  value  is  used  tor  all  names  input  when  the  FILE 
pair  a .meter  is  used. 

An  index,  containing  each  name  used  on  the  report  and  the 
page(s)  on  which  it  appears,  may  be  obtained  r>y  specifying  the 


page(s)  on  which  it  appears,  may  be  obtained 
INDEX  parameter. 


Analj£sjL  s 

Each  name  given  as  input  is  first  checked  to  see  that  it  is  in 
the  lata  base  and  that  it  has  one  of  the  legal  types  (ELEMFNT, 
ENTITY,  GROUP,  INPUT,  I NTH PEACE,  OUTPUT,  PFOCESS,  or  SET).  If 
the  name  is  not  in  the  data  base,  the  message: 

UFA  365:  JPSHCC:  NAME  NOT  IN  DATA  BASE 

will  be  jiven.  If  the  name  has  a type  which  is  not  in  the  list 
above,  the  user  will  receive  the  message: 


UP  A4 1 T : iiPSUCC:  NAME  NOT  ACCEPTABLE  TYPE  FOP  EP  REPORT 


It  the  name  passe;;  these  two  tests,  it  is  placed  in  a data 
structure  which  will  later  be  used  foL  output.  The  name  is  then 
used  to  jeneratv  a tt«>e  structure  as  follows.  Using  the 
relationships  in  the  appropriate  column  of  Table  3 or  Table  4, 
or  using  the  USED  TC  DERIVE  relationship  when  TtlFEAD  is  being 
used,  all  successors  tor  the  name  are  retrieved  from  the  data 
base  and  placed  on  a stack.  Then,  the  first  name  is  removed 
from  the  stack , placed  in  its  proper  location  in  the  data 
structure,  and  all  .successors  for  that  name  are  retrieved  and 
placed  on  the  stack.  This  procedure  continues,  with  names  beinq 
removed  from  the  fop  ot  the  stack,  placed  in  the  data  structure, 
and  used  to  obtain  further  names,  which  are  then  placed  on  the 
stack.  At  any  stage  of  this  procedure,  no  names  will  be  put  on 
the  stack  if  one  of  the  following  is  true: 


The  current  name  has  no  successors. 


Th«  current  name  has  been  encountered  earlier,  and  is 
therefore  at  the  end  of  a chain  or  forms  a loop  with  some 
portion  of  a chain  traced  earlier.. 

The  number  of  links  that  has  been  traced  on  the  current 
chain  is  eoual  to  the  limit  set  by  the  LINKS  paramter. 
(For  every  input  name  Cor  which  this  occurs,  the  message: 

"USER  LINK  LIMIT  CF  no.  ot  links  F F ACHED" 


will  be  printed.) 
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’’’has,  in  any  of  these  cases  the  size  of  the  stack  will  decrease. 
The  entire  procedure  is  complete  when,  after  any  search,  the 
stack  is  empty. 

The  data  structure  constructed  from  all  names  found  as  above  is 
broken  into  pane-sized  units  and  is  printed  a p.aqe  at  a time. 

The  process  described  above  is  repeated  until  no  more  names 
remain  in  the  input  stream. 


Osaue 

The  EXTENDED  PICTURE  is  very  similar  in  content  to  the  PICTUFE 
report  and  therefore,  most  usages  of  the  PICTUFE  report  apply  to 
the  EXTENDED  PICTURE  report. 

In  addition,  the  EXTENDED  PICTUPF  report  provides  a 
comprehensive  view  oi  the  information  flow  and  structure  aspects 
of  the  target  system  for  inclusion  in  the  final  specifications 
of  the  system,  or  as  an  rid  in  communicating  this  information  to 
others. 

Problem  def  iners  may  use  the  t; X T E N D P D PICTURE  report,  to  visually 
analyze  the  description  of  particular  objects  ana  the  system  as 
a whole,  for  completeness.  Table  r presents  all  completeness 
checks  that,  can  be  made  by  visually  scanning  FXTFNDEr  PICTUPF 
reports. 


Fiqure  31  presents  an  EXTLNDFD  PICTURE  of  structure  information 
for  the  PFOCESS  "hou rl y- em pi oyee- process i ng . " 

Figure  32  presents  and  EXTENDED  PICTUFE  of  data  flow  information 
for  the  INTERFACE  " pay r ol 1- depa r t me n t . " The  amount  of 
information  presented  was  limited  by  setting  l.INKS*3, 
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STF (IC^UFE: 


S’  T - r heck  th.it  SET  is  broken  down  into 

l'NTrns,  or  INPUTS  or  SETS. 


IhP’JT /0 U i PUT/  - check  Mut  those  arp  eventually  broken 
OFOUP/FNTIT  Y lowr.  into  ELEMENTS. 


OF OUP/ELSMENT  - chock  that  those  are  contained  within  seme 

larqer  <lata  structure. 


FLOW: 


Process  - chock  -hat  information  produced  is  used  in 

some  manner. 

- chock  thai  information  used  has  been  made 

available  (produced)  in  soma  manner. 

- chock  that  all  PFOC^SSES  interact  with  data 

in  some  manner. 


Tfi-'i^EACJ  • chock  that  those  all  generate  INPUTS  to 

the  system  and/or  receive  OUTPUTS. 

••  check  that  the  OUTPUTS  received  have  been 
.jererated  in  some  manner. 

- check  that  the  INPUTS  qeneratod  are  used  in 
sora«  manner. 


SET  - check  that,  all  those  are  USED,  UPLATED  and/or 

DEPIVKD  in  some  manner. 


INTUT/OUTPUT/  - check  th\t  all  those  are  produced  in  some 
ENTITY  manner  and/or  used  in  some  marner. 


OFOUP/ELEME  NT  - 


check  t hat  all 
manner  and/or 


thr>s-=  are  produced  in  some 
used  in  seme  manner. 


Table  c 


Complot t'liess  Checks  that  may  be  made  by 
Visual  Analysis  of  the  FVIFNDED  PICTUFF  Feport 
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FOPMATlhD  PFOPLJ.il  STATEMENT 


Purpose 

To  present  in  the  Lang u age  format',  all  (description  given  *bout 
one  or  more  num^s  in  an  Ar.  ilyzer  'data  base. 


Information  Present* d 

The  report  presents,  for  each  name  used  as  input  when  generating 
the  report,  all  information  direc* 1 y available  in  the  data  base 
for  that  name  and  its  relationships  with  other  names  in  the  data 
base.  Since  this  rcpor*  can  be  generated  for  any  type  of  name 
and  the  report  presents  all  Language  i e la ti onshi ps  specified  for 
each  name  type,  it  presents  all  the  relationships  tha*  are 
specified  in  Part  II  of  the  UTL  User's  Manual. 


Format 

All  information  presented  in  this  report  is  presented  as  leqal 
Language  statements  and  is  formatted  according  to  the  values  of 
the  margin  parameters.  The  margin  parameters  have  the  following 
effects  on  the  format: 


AKARG  - indicates  the  column  at  which  the  first  name  of  a 
name  pair  is  to  be  outputted. 


3M A RG  - indicates  the  column  at  which  the  second  name  of  a 
name  pair  is  to  be  outputted. 


CMArG  - specifies  the  number  of  columns  between  SMART,  and 
where  the  'ext  starts  for  a comment  entry. 


I'M  AEG  - indicates  the  column  where  the  user  defined  name-  in  a 
section  header  is  tQ  be  outputted. 


NKARG  - indicates  the  column  where  the  first  name  of  a name 
list  or  name  used  in  a language  statement,  is 
output  ted . 


FNMAFG  - specifies  the  right-hand  margin  lor  names  in  a name 
list. 


SKARG  - indicates  the  column  in  which  the  Language  statement 
headers  will  be  started. 
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Fiqure  33  illustrates  the  marqir  parameters  with  respect  to  a 
part  of  an  actual  FC  F >.  A T Tr.  P PRO  PL  EM  STATEMENT. 


1 


UK  A Si;1  <- 


1PKOCF.S3: 

I 


I salat  ied-empl  oyec-  processinq  ; 


DtT.CFI  P~ION: 

This  process  produces  the  pay  statement  tor  salaried 
<r~ 

iomployees  once  .a  month.  ; 

SYNONYM?  A F - : Is- em  p- proo , 

->!a3  ; 


I 

CK  A PG|— ^ 

I 

l 

A FO,  ^ 

NM  AFG’<— 

I ATTRTRUIEF  A ? E : 

AMAF  f.(  — ivjconipl  <j x it  v-  level 


RK AFfi,<- 


> 


h i q h ; 


l 

u. 


■Ml  Lanauaue  statements  presented  in  the  FPS  Feport  are  numbered 
sequentially  alon<i  the  left  m amin. 

For  each  type  of  Lanquaqe  sec  i or.  , t ho  statements  within  the 
section  are  ordered  as  qivon  in  Table  6.  Sections  in  the  F^S 
which  describe  undefined  names  or  relationships  not  allowed  by 
tie  svr.*ax  of  the  Lamjuaqe  are  presented  as  comment  statements, 
i.e.,  preceded  by  the  characters  /*  and  succeeded  by  the 
characters  */. 
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CONDITION  section 


DEFINE  section 


{ 


'It- A User's  Mtii.ual 


/*  Dr?  OF  I A 
SYNONYMS 
DESCFIPTU  N 
CEE- MFMO 
KE YWCFDS 
"■F  AC'*  KPY 
ATI  PIGMIES 
BFCONTNG  TFUF 
B ECO NINO 
PECO  NINO 
BFCOrTNC 
BECOMING 
DECO  NINO, 
BECOMING 
BECOMING 
BECOMING 
BECOMING 
M A DI  TF  ME 


: J-! 


ST  CHANGE  */ 


CAUSES 
FALSE  CAUSFS 
I F nr  IN7ERFUP1S 
FALSE  I NT  FRPUPTS 
TFUE  TFFMNATES 
FALSE  IE!' MI  NATES 
TFNE  TF.  IGGFRS 
FALSE  IFTGGi.FS 
TRUE  IS  CALLED 
FALSE  IS  CALLED 
BY 


MADE  FALSE  BY 
TF  f,F  WHILE 
FALSV  WHILE 
DEPENDS  ON 

responsible-  rr  cbLEM-  define  f 

SFCt’FITY 

SOUFCr 


/*  D ATE  GF  I AST  CHANGE  */ 

SYNONYMS 

DtSCFIPTlON 

SEE- MEMO 

KEYWORDS 

TP ACE- KEY 

ATTFTBUTFS 

APPLIES 

SUB SET” INC- CD  I TEF ION 

MAINTAINED 

/*  CONTAINED  */ 

CONNECTIVITY  V 
C&rriNALITY  */ 


/* 

/* 

/* 

/* 

/* 

/* 

/* 


HAPPFNS  TIMES-PEF  »/ 
HAPPENS  I.VEFY  */ 

WITHIN  APTEF  */ 
AFTEF  */ 


HAPPENS 
VALUE  */ 

RESPONS7BI.  E-  PFO  "L FN-  DEFINE' F 
SECUFITY 

soufce 


'"a  1: 1 r 


1H18  MM  IS  MSI 
I^Oii  FUKN1SFM)  10  DD.Q 
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FL  EM  ENT  hoc* ion 


ENTITY  section 


J 


/*  pat:-  of  last  chance:  */ 

SYNONYMS 
DESC  FT  PTIUN 
SFF- MFMO 
KEYWOFDS 
TFACF-KFY 
ATTFI  PMTL'S 
CONTAINED 

SUPSFTTINC.-CFITFFION 

IDFNTiriilS 

ASSOC  I AT  Cl)  WITH 

VALUFS 

I1SFP 

UPDATED 

DEFT  VFP 

CLASSIFICATION 
FESPONSIHLE-PFC  BI.FN-  DF FINER 
sy.CUPITY 
SOM PC F 


/*  DAT?  OF  LAST  CHANGE  */ 

SYNONYMS 

DESCF IPTICN 
SEE-MFMO 
KEYWOFDS 
TF  ACE- KEY 
ATTF IPMTF 5 
CONSISTS 
CONTAIN EL 
IDENTIFIES 
FE I A T SO 
USED 
UPDATED 
DERIVED 

CLASSIFICATION 
OCCUFF  FNCLS 
VOI.ATIII  T Y 

FESPONSIHLE-PFOULEM-DEFINEF 

SECUPTTY 

SOUFCE 

6 (continued) 
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2 3.1 


EVENT  aoct  ion  /*  FATr  OF  LAST  CHANCE  */ 

SYNONYMS 
DESCPT  TMON 
S r t**  M v C 
KFYWOFPS 

tfact-my 

A TT  F I pn fLS 

HAPPENS  TIMS*  F .1 

M A I F F ?.'c  V F F Y 

i*  A Pl,rN  S WITI'IK  AFTFF 

HArrFHf  A FT  TI 

OK  T N'CrPTT ON 

ON  ■’’F'-r.:  NATION 

CAUSE c 

CADS  FT 

INTEL FOPTS 

TFIOOr'S 

MAKE  ? 

:<  E ? POL  r 1 1>  I.  - - PE  OULI  M- 1)  KM  N i F 
SECURITY 

sour  c * 


OHO  IIP  section  /*  DAT'"  ( V LAST  C1IAKC.E*/ 

SYNONYMS 
DFSCPT PTieN 
SF  K- wFMO 
KEY  WOE  US 
?E  ACt-KF.Y 
ATTP  IPirjS 
CONSISTS 
CONTAIN  F.D 

S II  PS  FT?:  pi  0“  CHIT  F ION 

I PFNT I F I£‘o 

ASSCCT  .*  '"KD-  WMII 

MS  IT 

MPFAT^D 

PKFI V?n 

CLASSIFICATION 

H F S PO N ST  n 1. K-  F H C U L E M-  D t Y I N i l 

SECUFT^Y 

SOUFCf' 


T,»blt  b (con’-  imieil) 


giS  PAGE  IS  BEST  QUALITY  FTUCT1CABLS 
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/*  T ATF  CF  LAST  CHANGE  */ 

SYNONYMS 

DESCRIPTION 

SF.E-MF.rO 

KEYWOFDS 

TRACE- KEY 

ATTRIBUTES 

GENE PA TED 

PECFT VFD 

SUPPAFTS 

PART 

CONSISTS 

CONTAINED 

USED 

clasp: fixation 

HAPPENS  '*  I MES-  PER 

HAPPENS  i VERY 

HAPPENS  WITHIN  A FTFF 

HAPPENS  AFTER 

CAUSFS 

INTEr FUPTS 

TERMINATES 

TFT  GOFFS 

MAKES 

FFSPON^IHl.E-PFOBLE.M-LFFINEF 

SFCUFIT Y 

SOUFC* 


INTc'FEACF  section 


/*  PATE  OE  LAST  CHANGE  •/ 

S YNON  Y V(r 

m sc^iptioi: 

SEE-MFMO 
KEY  WORTS 
TFACF-KFY 
ATTFIHUTES 
GENE  FATES 
FECEIVFS 
R ESPONSIHLE 
SUBPAFTS 
PART 

SECURITY- ACCESS- F IGHTS 

RF.  S PONS  I BLE-FFOBLFM- DEFINES 

SFCUPITY 

SOUFCE 

b (continued) 


« 
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/*  PAT  OF  LAST  CHANCE  */ 

SYNONYMS 

PE  SC  T TPTION 

SEE-MFMO 

KEYWOF^S 

"■FACE-  KEY 

ATTrI  n"Tl.S 

CONSIST'' 

/♦  CONTAINED  ♦/ 


/* 

HAPPENS 

TIMFS- 

PFP  */ 

/* 

HA  !'  1'c.ti C 

£,V“FY 

*/ 

/* 

HAPPENS 

WITHIN 

A FT  F :<  ♦/ 

/♦ 

HAPPENS 

t FT  LF 

*/ 

NF 

S PON  r TUI 

F-PFOU  L 

FM-DLFIN F 

SEC  in  I TY 
SOIIFCF 


/*  r A T V 0 ? IASI  CHANT,  r */ 

SYNONYMS 

PESO! TPTION 

KEYKOFDS 

TPACF- K^Y 

A?tfi PUTLF 

a ppi irs 

f ? s po t; r : hi  f - pfo h l f m-iukin f: h 

SFICI'F  :ty 

SOIIFCF 


/*  PATr  OF'  LAST  CHANCE  •/ 

SYNONYMS 

PESci-rmoN 

cwe—i'EMC' 

KFYWOFDS 
TFACF-KFY 
ATT"  TPIITFS 
UF'NF  F A~  SI) 

feck: vv  r 

Sll  HP  ArTS 
PAFT 

CONSISTS 
CONTAINED 
DEFI VFD 

CLASSI  FICA  HON 
HAPPENS  T 1 M r P i:  F 
HA  I FENS  dV  r.PY 


1 


T »!>1  e 


HAPPEN  s WITHIN  AFTF.F 
H A T P F NT  A FTF 

FESPONSTBI.  I - PFO  PI. I'M- DEFT  N I i 
SLCHFTTY 

sour  c- 

f-  (cor:  ♦ i hu.mI) 


™ n "»«««* 
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P H 0 H L 2M-  P F P I N K 1 i <>ri  /*  PJVTF  G V LAST  CHANGE  */ 

SYNONYM 

DESCRIPTION 

o IT-. MEMO 

KSYVOPPS 

TFACr-KEY 

ATT  F I PUTr  3 

mailbox 

RESPONSIBLE 

SECUFITY 

SOHPCF 


Phi  CESS  ion 


/*  DAT”  OF  LAST  CHANGE  */ 

SYNONYMS 

DESCFIPTION 

SEF- hfmo 

KEYWOFD3 

TRACS-  KEY 

ATTRIBUTES 

GENFFA  7FS 

RFC FI  VI c 

SUPPAFTS 

PA  FT 

UTI LT7F3 

UTIl  T2TP 

PT E FORMED  PY 

FE SOURCE- USAGE 

IISES 

U P C A T F c 

PEF I VF  ^ 

PFCCEDURc 

MAINTAINS 

SECUFITY-  ACCESS-  FIGHTS 
HAPPENS  1 I M*iS-  Fi I 
HAPPENS  1 VEF  Y 
HAPPENS  WITHIN  AETFP 
HAPPENS  AFTER 
INCEPTION-CAUSES 
TERMINATION- CAUSES 
INTFPRUPTS 

intfpfiiptsd  PY 

TFr.MINATtD 

TFIGGEPS 

TRIGGERED 

MAKES 

FES  PON  SIP  L L-  PFCPLLM—  HI  FINEF 

SFCU  PI T Y 

SOUFCF 


■’■jHle  f.  (continued) 
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PROCESSOR 


FELATION 


section  /<•  DATE  OF  LAST  CHANGE  */ 

SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

TPACF-KEY 

ATTRIBUTES 

GENEPATES 

RECEIVES 

SU  PPAPTC 

PART 

CONSUMES 

PEFEOPMS 

UTILIZES 

UTILIZED 

PE  PEOFM  FD  BY 

FF. SOURCE-  USAGF 

USES 

UPDATTS 

DEFT VFS 

PFOC'TUPL 

MAINTAINS 

SECURITY-ACCESS- FIGHTS 

INCEPTION-CAUSES 

TERMINATION-CAUSES 

INTERRUPTS 

T NTFF  FUPTED  BY 

TEFMINA^ED 

TRIGGERS 

TFIGGER  ED 

MAKFS 

FESPONSIULE-PFOBLEM-DEFJNFF 

SECURITY 

SOUFCF 


section  /*  DATF  OF  LAST  CIIANGL  */ 

SYNONYMS 

DESCRIPTION 

SEF-MFMO 

KFYWORDS 

TPACF-KEY 

ATTFIBUTlS 

ASSOCIATED-DATA 

BET VrFN 

DERIVATION 

MAINTAINED 

CONNFCTIVITY 

CARDINALITY 

RESPONSIBLE- PROBLEM- DEFINEP 

SECUPITY 

SOURCE 

Table  6 (con’  ir.u«>il)  THIS  PAGE  IS  BEST  QUALITY  FRACIICA^U 

THOM  CORY  FUhNloHKD  I\)  uDC  — 
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RESOURCE  section 


/*  DAT?  OF  LAST  CHANGE  */ 

SYNONYMS 

DESCRIPTION 

SEF-KEMO 

KEYWOFDS 

TFACF-KEY 

ATTRIBUTES 

CONSUMED 

MEASURED 

RESPONSIBLE- PFOBLEK-DEFINEF 

SECURITY 

SOUFCF 


RESOURCE- US  AGE- PA FAKE T2F  section 

/*  DATE  OF  LAST  CHANGE  */ 

SYNONYMS 

DESCRIPTION 

SEE- MEMO 

KEYWOFDS 

TRACE-KEY 

ATTRIBUTES 

RESOURCE-USAGE-PAF  AMETL’F-  VALUE 

COMPUTER- PFOCESSOF-CONSUMES 

FESPONSIBLE-PFORLEM-D2FINER 

SECURITY 

SOURCE 

Table  f (continued) 
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SET  section 


UNITS  section 


/*  DATE  OF  LAST  CHANGE  */ 

SYNONYMS 

DESCF IPTION 

SEE-MEMO 

KFYWOPDS 

TPACF-KEY 

ATTRIBUTES 

ASSEPT 

E ESPON  ^IBLE-INTFFFACE 

SUPSETS 

SUBSET 

CONSISTS 

SU PS FTTING- CRITERIA 

USED 

DERIVED 

UPDATED 

DEP I V ATION 

CLASSI FIC ATION 

OCCUFFENCES 

VOLATILITY-KEMBEF 

VOI ATTLITY-SET 

RESPONSIBLE- FPOBLEM-DEFINFF 

SECUFTmY 

SOURCE 


1 


/*  DATE  OF  LASI  CHANGE  */ 

SYNONYMS 

DESCF IPTION 

SEF- MEMO 

KEYWORDS 

TRACE-KEY 

ATTPIPUTES 

ASSEPT 

KEASUPES 

RESPONSIBLE- PFORLFK- DEFINED 

SECUFI"Y 

SOUPCE 

Table  6 (continued) 


SSSSSJSSSS* 
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In  addition  to  th*1  margin  parameters  described  above,  a few 
other  parameters  which  modify  the  format  in  some  way  are  given 
below  with  the  effect  they  have  on  the  report  format. 


1)  NFW-LINE  - specifies  that  the  first  name  in  a list 

cr  names  for  Language  statements  is 
started  on  the  line  following  the 
statement  header. 

NONEW-LINF  - specifies  that  the  names  in  the  name  list 

begin  on  the  same  line  as  the  Language 
statement . 


For  example,  with  NEW-LINE  in  effect,  a Language  statement 
would  be  printed  as  follows: 


SYNONYMS  ARE: 

s-emp- proc, 
s3; 


With  NONE W- LINT  in  effect,  the  statement  is  printed  as 
follows: 


SYNONYMS  ARE:  s-emp-  proc, 

s3 ; 


2)  NEW-PAOF  - specifies  that  each  section  (description 

of  single  name)  presented  in  the  report 
would  be  printed  beginning  at  the  top  of 
a new  page. 


NONSW- PAO 


specifies  that  sections  are  printed  one 
after  another  without  a new  page  being 
started . 


3)  ONE-PEF-LINF 


specifies  that  the  names  in  a name  list 
within  a given  statement  be  presented  one 

per  line. 


SE’VEFAL-PER-LTNF 

- specifies  that  the  names  in  a name  list 
be  presented  as  many  as  possible  on  a 
line. 


For  example,  with  ONE-PER-LINF  in  effect  a Language 
statement  would  be  printed  as 


SYNONYMS: 

s-emp-proc, 

a3; 


With  SEVLFAL-PFP-LINF  in  effect  the  statement  is  printed  as 


j 
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SYNONYMS: 

s-emp-proc,  si; 

Some  information  in  the  FPS  can  he  included  or  left  out, 
depending  on  the  parameters  used  when  generating  it.  Each 
parameter  and  its  effect  is  given  below. 


1)  COMMENT  - specifies  that  connien*  statements  for 

descriptions  ot  undefined  names  and 
complementary  relationships  not  allowed 
by  the  Lanaquage  syntax  are  to  be 
included  where  applicable  in  the  report. 

NOCOMMENT  - specifies  that  the  comment  statements  are 

not  to  be  printed. 


2)  DEFINE  - specifies  that  descriptions  for  names 

which  are  described  by  a DEFINE  section 
{ATTRIBUTE , ATTRIBUTE- VALUE,  KEYWOFD, 
MAILBOX,  SECURITY , SOURCE,  SUPSETTING- 
CRITEFION , and  SYSTEM- PA RAMETER  names) 
are  included  in  the  report  when  these 
names  are  given  as  input. 


NODEFINE  - specifies  that  the  description  of  any 

name  described  by  a DEFINE  section  is  not 
presented  ir.  the  report 

3)  DESG  - specifies  that  the  descriptions  for  names 

which  are  SYNONYMS  for  other  names  in  the 
data  base  are  presented  in  the  report  by 
the  DESIGNATE  section. 


NODESG  - specifies  that  the  descriptions  for  names 

that  are  SYNONYMS  are  r.ot  to  be  presented 
in  the  report. 


4)  ALL-STATEMENTS  (AS) 

- specifies  ♦■hat  all  legal  statements  for 
each  section  will  be  printed  whether 
information  was  supplied  or  not. 

NOALL-STATEMENTS  (NAS) 

- specifies  that  only  those  statements  for 
which  there  is  information  contained  in 
the  data  base  will  be  printed. 

5)  LINE-NUMBERS (LNS) 

- specifies  that  line  numbers  are  *o  be 
printed  on  the  left  side  of  the  report. 

NOLI NE-NUM PER S (NLNS) 

- specifies  that  line  numbers  should  not 
appear  on  the  report. 
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6)  PF INTF.OF  (PEOF)  - specifies  that  an  extra  line  containing 

EOF  is  to  be  produced  at  the  end  of  the 
output. 

7)  COMPLEMENTAFY-STATEMENTS  (COMP) 

- specifies  that  compleraen tary  statements 
will  be  produced,  if  applicable,  in  each 
section  of  the  report. 

NOCOMPLEKE NT ARY- STATEMENTS  (NCOMP) 

- specifies  that  no  complementary 
statements  will  be  output.  Only 
statements  in  the  "present  tense"  are 
printed,  e.g.,  RECEIVES  and  TFIGGEBS  as 
opposed  to  the  complementary  RECEIVED  Bf 
and  TRIGGERED  BY.  Thus  the  number  of 
statements  is  the  minimum  necessary  to 
describe  the  information  in  the  data  base 
for  this  section. 

9)  DLC- COMMENT (DLCC) 

- specifies  that  the  Formatted  Problem 
Statement  for  each  name  includes  a 
comment  which  indicates  the  date  and  time 
of  the  last  change  made,  to  that  name. 

NO DLC- COWMEN T(NDLCC) 

- specifies  that  a date  of  last  change 
comment  will  not  be  printed  as  part  of 
the  FPS  report. 

For  each  name  given  as  input  to  the  command  producing  the 
report,  the  report  presents  the  appropriate  section  to  describe 
the  name.  For  example,  when  a PFOCESS  name  is  given,  it  is 
described  in  a PFOCESS  section.  Therefore,  when  a SYNONYM  name 
is  given  as  input,  the  report  describes  the  SYNONYM  by  a 
DESIGNATE  section  rather  than  presenting  the  description  of  the 
name  the  SYNONYM  name  applies  to. 

An  index  for  the  report  is  generated  when  the  INDEX  parameter  is 
used. 

The  report  may  be  generated  for  a single  input  name  (via  the 
NAME  parameter)  or  for  a collection  of  input  names  either 
specified  by  the  user  or  retrieved  via  NAME-GEN. 


Analysis 

Each  name  given  as  input  is  first  checked  to  see  that  it  is  in 
the  database.  If  it  is  not.,  the  message: 

/*  NAME  NOT  FOUND  IN  D.P.-  */ 
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is  printed  on  the  report. 

If  DLC-COKM  ENT  parameter  is  specified,  a date  of  last  change 
comment  will  he  printed  as  part  of  each  section  header 
statement.  Each  relationship  the  name  has  with  other  names  is 
printed  in  the  format  of  a legal  lanaguage  statement.  If  no 
statement  exists,  the  relationship  is  presented  as  a comment 
entry.  Since  no  Language  section  is  available  to  describe  an 
UNDEFINED  name,  the  description  of  the  name  and  relationships  it 
has  wi*-h  other  names  are  presented  as  a comment  statement. 


tisane 

Since  the  FPS  presents  all  the  description  given  about  each  name 
in  the  data  base,  the  report  is  boreficial  m checking  the 
accuracy  of  each  description.  It  is  usually  recommended  that  an 
FPS  for  all  names  be  maintained  as  a reference  and  updated  when 
changes  are  made  to  the  data  base. 

When  maintaining  an  up-to-date  copy  or  the  FPS,  it  is  often 
desirable  to  generate  the  FPS  for  all  names  in  the  data  base 
with  the  NEW- PAGE  option.  Any  modifications  to  the  description 
ir.  the  data  base  can  be  recorded,  by  generating  an  FPS  (with  the 
NF.W-PAG2  option  again)  tor  those  names  at  looted  by  the 
modi f icat ion . 


Examples 

Figure  34  presents  an  FPS  for  a single  name.  This  example  was 
generated  by  the  following  command: 

FO  FM  A T?  E D- PH  C3L  EM- ST  A TF  M F N T NAME - payroll-processing 

Figure  35  presents  the  report  for  all  ENTITY  names  defined  in  a 
particular  lata  base.  This  example  was  generated  by  the 
following  commands: 


NAME-GEN  S='FNT:TY' 
FPS 
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Pit  mono 

To  wreaont  all  information  based  cn  the  uso  oi  » M 1 
statement  in  .1  pa it ion l.i t Analyze!  1l.1t  1 h.v.o. 


i 


Information  ff^-Aentod 

The  report  presents  size  ami  volume  in  t orma  t.  tot.  atu  a L N'  , 

OUTPUT,  PROCESS  an!  EVENT  names  defined  in  the  ’ ta  >i..e  Ki'i 

respect  to  * h<  HATPINS  r.t  dements  connect  ed  to  1 1- • 

names.  An  entry  is  made  in  the  report  tot  each  . N >TP< 

PR0C3SS  an. I cIVEN"’  with  a It  A P TENS  statement  ai  I . 1 i •>  m* 

grouped  1'y  the  INTERVAL  ovor  which  tin  IIAPPFN 

effective. 

SYS  i’SE-  PA  F.\. "INTERS  lie  contained  i r.  each  entiv  to  dilitt  a number 
which  relates  the  name  to  the  entry  and  the  N’t  'KVAJ.. 


Form  it 

The  report  presents  all  MAP  PENS  st  item.-nts  1 » la  ivo  t 
specific  INTERVAL  name.  Pot  each  INTERVAL,  t h t e«  ! i.l  11.)  > ire 
printed  an  1 the  frequency  mtormat  ion  pot  taming  t<  the 
particular  INTERVAL  is  listed  helow  these  he  id  no  . 
headings  are: 


S' A! 


TYPE 


the  names  of  the  INPUTS,  OUT IMITS,  t’hOCLSSFS 
f VENTS  which  HAPPEN  w i Mt  i n the  -le.ionat*  1 IN" 
are  listed. 


the  name  type  of  each  ot  the  name  . livui  un  lei,  NAME 
is  listed. 


HAPPENS  - all  of  the  HAPPENS  relationships  between  e a name 
and  Mie  ijivjn  interval  aio  listed. 


The  INTERVALS  are  presentee  alphabetically  in  the  > ,01  t.  rhe 
names  presented  within  each  INTER  VAl  can  ,'ipp*  1 il  tbetically 
01  by  object  type  as  specified  wi’h  the  CPIH  - p.uanu  ei  when 
the  NEW-PAO.E  parameter  is  in  ettect,  each  IN,m|-rvA,  1 ime  will 
begin  on  n new  page. 


Options  ji od  ^iieLilili ^ js 


"'here  ire  a wo  parameters  that  a t I e<  * the  format  oi  the  report  a* 
described  above.  The  ORDER  parametei  specific*  the  egumnce  in 
which  the  names  presented  with  it  each  interval  1 toon  of  the 
report  will  appi-ar.  It  the  value  PYTYPE,  th>  ofault  va  u,  is 


- -1- 


Ji 


Part  111  UFA  Outputs 


•IP  A dial's  r -ir.ua  1 


ussi  jji»  1 t ) tin  'h  '1  ’ parameter,  t he  names  within  each  interval 
ration  will  1 qruuped  by  luimt'  tvpr.  I;  tin?  value  ALPHA  it 
v 1 < all  r>n  . waMiin  each  interval  c*  i on  will  be 

a l i in  i > l 1 1 t he  bt  ♦ ica  1 1 y . 

The  NEW-  parameter  specifies  that  each  interval  .section 

will  beau  i ’ w paae.  It  not  explicitly  qiven,  th(>  Ufault 

i , the  NON  W-PAO  • (NNl’d)  parameter. 

An  ind<  x,  out  tinitaq  each  name  used  on  Mu*  report  and  the 
paio(s)  oi  which  x*  appears,  may  be  obtained  ny  specifying  the 
I N DE'X  p 1 1 ante  te  r . 


Ana lysi s 

The  data  bis  **  is  t i l • * s«airh»d  *-o  determine  whether  there  is 
any  INTE&VAt.  iianiti  that  is  connected  to  a HAPPENS  relationship. 
It  none  is  found,  the  messaqo: 

IIRA  \ >:  dAINFROP:  NO  HAPPENS  FLLATION  ich  user-name 

is  printed,  inch  INTnVAl.  name  found  i:  retrieved  and  tor  each 
name  r»  late  1 to  i * vi  i a HAPPENS  st  a*ement  , til  ot  the  HAPPENS 
i elation  . eti  * . n a be*-  ween  that  i tm**  and  the  1NTEKVAL  are 
ret  r i e v e 1 . 


The  report  is  Helpful  to  analysts  in  checkin. i that  all  items  in 
the  !e  'CM'tion  which  tr°  to  he  lonically  related  via  their 
frequency  are  <;roup»d  together. 

•facial  to  system  designers  when 
consnie  i nq  on  relationships  oi  various  parts  of  system  with 
respect  to  t h*  tit  nancy  of  occurrence,  and  the  amount  ot  input 
and  output  *■  o la  handled  by  the  tuiqet  system. 


E xumpj.es 

Fiqures  3 f and  37  present  the  FKFQOFNCY  FEP0R7  for  a I.anquaqe 
description  ot  a tara<  t system.  These  wore  generated  by  the 
command  ■ 
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Pu : poso 

To  present  ill  i nf  01  ma  t ioii  based  cn  Mie  usp  of  IDENTIFIERS  for 
ENTITIES  in  a particular  Analyzer  dati  base. 


If  IDENTIFIER  names  are  used  as  input,  wh*  n generating  this 
report  (and  the  IDENTIFIER  parameter  is  specified),  those 
ENTITIES  which  the  input  names  irEN"'IFY  are  presented  in  the 
report. 

If  ENTITY  names  are  used  as  input  when  generating  the  report 
(and  the  ENTITY  parameter  is  specified) , those  IDENTIFIERS  which 
the  input  n uni  s are  IDENTIFIED  by  are  • resent*  d in  the  report. 

In  either  case,  the  information  is  presented  as  a matrix.  An 
analysis  of  the  information  in  the  matrix  produces  some 
statistics  shoving  the  number  ol  IRENTIE  ERS  each  ENTITY  in  the 
matrix  had  and  'he  number  ot  ENTITIES  each  It  EMI  FIEF  identifies 
in  the  matrix. 


Fo  i m a t 

If  the  IDENTIFIER  parameter  is  used  when  generating  the  report, 
any  names  given  as  input  which  do  not  IDENTIFY  any 'ENTITY  in  the 
data  base  are  flagged  at  the  beginning  or  the  report.  If  the 
FNTITY  parameter  is  used  when  generating  the  report,  any  names 
given  as  input  which  are  rot  IDENTIFIED  by  any  IDENTIFIER  in  the 
data  base  are  flagged,  it  the  beginning  ot  the  report. 

Two  lists  of  names  are  then  presented,  one  labeled  ROW  NAMES  and 
the  other  COLUMN  NAMES.  It  Mie  IDENTIFIER  pA'Jramoter  was  used 
when  generating  the  report,  the  names  designated  as  FOW  NAMES 
are  those  which  ver<  given  as  input.  If  the  ENTITY  parameter 
was  used  wh°n  generating  the  report,  the  names  designated  as 
COLUMN  NAMES  are  those  which  were  given  as  input. 

In  any  case,  each  name  under  FOW  NAMES  IDENTIFIES  one  or  more 
names  under  COLUMN  NAMES  and  each  name  under  COLUMN  NAMFS  is 
IDENTIFIED  bv  one  or  more  names  under  ROW  NAMFS. 

A matrix  is  then  printed  t.o  show  the  relationships  between  the 
names  designated  as  FOW  NAMES  (which  are  represented  by  the  rows 
ot  the  ma*""iv)  and  the  names  designated  as  COLUMN  NAMES  (which 
are  represented  by  the  columns  of  the  matrix) . The  rows  and 
columns  ot  the  matrix  are  numbered  *c  correspond  to  the  number 
assigned  to  -Mch  name  in  the  ’is*  ■ C.  * NAMES  and  COLUMN  NAMES, 

respective! y . 
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An  asterisk  (*)  entry  at  the  intersection  ot  a particular  row 
and  column  of  the  matrix  designates  ♦■hat  the  name  represented  by 
the  row  IDENTIFIES  the  FNTITY  represented  by  the  column. 

Inspection  of  an  entire  row  reveals  all  ENTITIES  that  a 
particular  name  (represented  by  the  row)  IDENTIFIES.  Inspection 
of  an  entire  column  reveals  all  IDENTIFIERS  for  the  particular 
name  represented  by  the  column. 

A summary  section  is  a Iso  included  in  the  report  presenting  for 
each  EOW  NAME: 

- The  row  it  was  represented  by  in  the  matrix  (ROW). 

- Its  name  type  (TYPE). 

- The  number  ot  * entries  in  its  row  (or  the  number  of 
ENTITIES  it.  IDENTIFIES)  (COUNT)  . 

The  "•'mmary  presents  for  each  COLUMN  NAME: 

- The  column  it  was  represented  by  (COLUMN)  . 

- Its  name  type  (TYPE). 

- The  numher  of  * entries  in  its  column  (or  the  number  of 
IDENTIFIERS  for  it)  (COUNT)  . 

The  summary  section  for  ROW  and  COLUMN  names  is  ordered  in 
decreasing  order  of  COUNT. 


Options  and  Alternat i yes 

The  report  must  be  qenerated  using  either  the  IDFNTI FIEP  or 

ENTITY  parameter.  If  the  IDENTIFIER  parameter  is  used,  all 

names  given  as  input  must  be  IDENTIFIER  names.  If  the  ENTITY 

parameter  is  used,  all  names  given  as  input  must  be  ENTITY 

names.  ] 

The  report  may  be  generated  for  a single  input  name  (via  the 
NAME  parameter)  or  for  a collection  of  input  names  either 
specified  by  the  user  or  retrieved  via  NAF.E-GEN . 


Malxsis 

For  each  name  given  as  input,  the  software  finds  the  name  in  the 
data  base.  If  the  name  is  not  found,  the  message: 


URA099: IDFNTF : NAKF  NOT  IN  D.  F.  - or 

UF A052: IDENTC:  NAME  NOT  IN  D.P.  - 

is  printed  depending  on  whether  the  IDENTIFIER  or  ENTITY 


i 

l 


Part  ill  UFA  Outputs 


UFA  Useu':~  Manual 


261 


parameter  was  specific!  foL  the  command,  respectively. 

If  the  IDENTIFIER  parameter  is  used,  each  name  given  as  input  is 
checked  that  it  IDENTIFIES  one  or  more  ENTITIES.  If  it  does 
not,  the  name  is  listed  under  the  message: 

URA3d4  : IPfiNT  F.:  THE  FOLLOWING  N AM  DO  NOT  IDENTIFY  ANYTHING 

The  SN77?I~C  that  are  IDENTIFIED  by  the  input  names  are  fount. 
The  list  of  all  input  names  and  ‘•he  list  of  all  ENTITIES 
retrieved  is  then  printed. 


If  the  ENTITY  parameter  is  used,  each  name  qivf  n as  input  is 
checked  that  it  is  IDENTIFIED  hy  one  or  more  ID ENTI FIEFS.  If  it 
does  not,  the  name  is  listed  under  the  message: 

UE  A30H : I DFN  TC:  THE  FOLLOWING  NAMES  A FE  NOT  IDENTIFIED  BY 
ANYTHING 

The  IDENIIFIEhS  for  the  ENTITIES  given  as  input  are  found.  The 
list  of  all  input  names  and  the  lis*-  of  all  IDENTIFIERS 
retrieved  is  then  printed. 

A matrix  is  printed  out  to  illustrate  the  relationships  between 
the  names  in  the  two  lists  and  each  relationship  is  designated 
by  an  asterisk. 

A summary  is  then  produced  by  counting  the  number  of  asterisks 
appearing  in  each  row  and  column  of  the  matrix. 


Usage 


The  report  presents  information  ‘■hat  aids  the  analyst  in 
checking  the  completeness  and  consistency  of  the  problem 
statement  by: 

1)  - identifying  those  ENTITIES  which  do  not  have  IDENTIFIERS. 

^his  can  be  accomplished  by  Mio  following  Analyzer 

comman ds: 

NAM. F. -GEN  S = ' ENTITY' 

ENTITY- IDENTIFIER  FNTITY 

2)  - being  in  an  easv- to-a na 1 yze  format  to  check  that  the 

IDFNTI FIEFS  defined  for  the  problem  statement  are  being 
used  properly.  For  example,  a typing  error  may  result  in 
an  IDENTIFIER  being  used  in  the  wrong  context. 

The  report  aids  the  system  designer  by  presenting  those  ENTITIES 
with  the  same  IDENTIFIERS  and  aids  in  determining  a consistent 
and  well-defined  identifier  coding  structure. 
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Exam  pi** 

Figure  38  presents  the  report  using  the  ENTITY  parameter. 
Analyzer  commands  used  to  qenerate  this  exaaple  were: 

NAEE-GEN  S= ' ENTITY ' 

ENTITY- IDENTIFIEF  ENTITY 


The 
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INTER VAL  CONSISTENCY  PEPORT 


Pucposp 

To  show  all  levels  of  interval  structures  described  in  the 
Analyzer  data  base  as  specified  by  the  use  of  the  CONSISTS 
statement . 


Information  Presented 

The  INTERVAL  CONSISTENCY  HEPOPT  presents  all  lcwer  composition 
levels  for  INTERVAL  names  used  as  input.  All  of  the  names  which 
the  input  names  CONSIST  of  are  designated  as  level  2 names;  the 
names  that  the  level  2 names  CONSIST  of  are  designated  as  level 
3 names,  etc. 

The  CONSISTS  statement  allows  network  structures  to  be 
constructed  since  any  given  INTERVAL  may  be  CONTAINED  in  more 
than  one  structure,  and  at  different  levels  in  the  different 
structures.  The  only  type  of  name  presented  in  the  structure 
will  be  INTEFVAL. 


Format 

Each  name  given  as  input  to  the  report  is  identified  by  a number 
1*,  2*,  etc.,  designatinq  its  position  in  the  list  of  input 
names  and  also  by  the  number  1 designating  it  as  a level  1 name. 
All  names  that  are  part  of  this  structure  are  numbered  one 
through  n according  to  its  position  in  the  structure  when 
printed  out,  and  also  numbered  according  to  the  names  relative 
level  in  the  structure.  Each  level  2,3  and  so  on  is  indented  to 
further  accent  the  idea  of  structure. 

The  VALUE  of  the  SYSTE1-PAF AMETEP  connected  with  each  name  is 
printed  out  within  parentheses  just  after  the  name  (except  for 
names  at  level  one).  If  there  is  no  VALUE  defined  for  the 
SYSTEM-PAPAMETER,  then  the  message  (*UN KNOWN  (system- pa rameter 
name))  will  appear  just  after  the  INTERVAL  name.  For  example, 
the  following  URL  description: 

INTERVAL  year; 

CONSISTS  fifty-two  week, 

twelve  month, 
three-hundred-sixty  day; 

INTERVAL  week; 

CONSISTS  seven  day; 

INTERVAL  month; 

CONSISTS  four  week, 

thirty  day; 
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INTERVAL  days; 

DEFINE  fifty-two  SYSTEM-PAF AMETEF; 

VALUES  52; 

DEFINE  twelve  SYSTEK-PARAKETEF ; 

VALUES  12; 

DEFINE  thirty  S Y STEM- PARAMETER ; 

VALUES  30; 

DEFINE  seven  S YSTEK-PA RAMETEF ; 

VALUES  7; 

DEFINE  four  SYSTEM-PARAMETER; 

VALUES  4; 

DEFINE  three- hundred-sixty  SYSTEM- PARAMETER 
VALUES  360; 

would  appear  as: 

1*  1 year 

1 2 week  (52) 

2 3 day  (7) 

3 2 month  (12) 

4 3 week  (4) 

5 4 day  (7) 

6 3 day  (3C) 

7 2 day  (36C) 


in  the  INTERVAL-CONSISTENCY  PEPOFT  if  the  report  was  qenerated 
for  the  name  year.  If  the  report  was  qenerated  for  the  name 
month,  the  followinq  structure  would  appear; 

1*  1 month 

2 week  (4) 

3 day  (7) 

2 day  (30) 


gfiUgns  Ml  AUSIMlAlgs 

The  user  may  restrict  the  number  of  levels  of  the  dat^ 
structures  presented  when  a numerical  value  is  assigned  to  the 
LEVELS  parameter.  For  example,  when  LEVELS*2  is  given,  only  the 
names  of  levels  one  and  two  of  the  data  structure  are  presented 
in  the  report.  The  default  for  t„he  report  is  to  present  ALL 
levels  of  the  data  structures. 

An  index  of  names  used  in  the  report  is  produced  when  the  INDEX 
parameter  is  used. 

The  report  may  be  qenerated  for  a single  input  name  (via  the 
NAME  parameter)  or  for  a collection  of  input  names  either 
specified  by  the  user  or  retrieved  via  NAME-GEN. 
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Analysis 

Each  name  given  as  input  is  first  checked  to  see  if  it  is  in  the 
data  base.  If  the  name  is  not  found,  the  message: 

URA369:  MAINIC:  NAME  NOT  FOUND  IN  D.B. 

is  printed  and  no  structure  information  is  printed  for  that 
name . 

Each  name  is  then  checked  to  see  if  it  is  an  INTERVAL  name.  It 
it  is  not,  the  following  message  is  generated  and  no  structure 
information  is  printed  for  that  name: 

UFA366:MAINIC: NAHE  NOT  AN  INTER  V Al- 

For  each  name  given  as  input,  each  interval  name  that  it 
CONSISTS  of  is  designated  as  a level  2 name  as  it  is  printed. 

If  this  level  2 name  CONSISTS  of  anv  intervals,  then  each  name 
which  it  CONSISTS  of  is  designated  as  a level  .1  name  as  it  is 
printed.  This  process  continues  until  no  more  CONSISTS 
relationships  are  found  or  the  level  specified  by  the  LEVELS 
parameter  is  reached.  Names  are  printed  out  as  they  are 
encountered  in  the  structure. 

A consistency  check  is  performed  whenever  a name  is  connected 
with  upper  level  names  by  two  or  more  different  paths  in  the 
network.  When  this  is  the  case,  all  the  different  paths  from 
the  name  until  the  top  of  the  structure  are  followed  and  the 
consistency  check  between  different  paths  is  performed  by 
multiplying  the  value  of  the  SYSTEM- PARAMETERS  connected  with 
all  the  names  encountered.  An  inconsistency  will  be  recognized 
whenever  the  results  of  the  mentioned  multiplication  are 
different  for  the  different  paths.  Inconsistent  structures  will 
be  flaqqed  by  the  messaqe: 

♦♦♦THE  FOLLOWING  PATHS  FROM  name-i  TO  name-n  AFE  INCONSISTENT: 

THE  PATH  name-i > name--j > name-k  ...--->  name-n 

HAS  A VALUE  OF  sys t em- pa rameter- va lue- 1 name-n 

THE  PATH  name-i  --->  name-x > name-y  ...--->  name-n 

HAS  A VALUE  OF  system-pa  rameter- va  lue- 2 name-n 

When  a SYSTEM-PARAMETER  without  a value  connected  to  it  is 
encountered,  the  consistency  check  could  not  be  performed  and  a 
messaqe  will  be  printed  out: 

♦*  CONSISTENCY  CHECK  CAN  NOT  BF  PERFORMED  ♦♦ 

In  the  example  above,  it  can  be  noted  that  the  structure  for 
year  is  inconsistent.  This  name  was  defined  as  52  weeks  and 
every  week  as  7 days,  so  a year  consists  of  364  days.  On  the 
other  hand,  year  was  also  defined  as  Jet  days.  Also  year  was 


defined  in  terras  of  12  months,  a month  as  4 weeks  and  a week  as 


1 1 
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7 days.  That  leans  a year  consists  of  336  days  also. 


It  should  be  noted  that  the  consistency  check  is  nade  for  the 
units  of  the  interval  the  user  defined  and  not  for  real  periods 
of  tine. 


Usaas 

The  report  presents  information  for  the  analyst,  about  INTERVAL 
structures  as  defined  by  the  use  of  the  CONSISTS  statement, 
using  a format  in  which  the  entire  structure  can  be  seen.  An 
automatic  consistency  check  is  perforaed  for  each  structure. 
Incompletenesses  with  regard  to  system- parameter  specifications 
are  flagged  for  the  user. 


Examples 

Figure  39  presents  the  report  using  the  NAME  parameter.  Figure 
40  illustrates  the  use  of  a file  or  names  given  as  input  and 
restricting  the  analysis  to  three  levels.  The  commands  used  to 
generated  these  examples  were: 

INTERVAL-CONSISTENCY  N*year 

NG  S*"INTER VAL"  NP 
IC  F LEVELS*3 

1 
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KWIC  INDEX 


Purpose 

To  present,  in  an  easy  to  inspect  format,  logical  groupings  of 
names  defined  in  a particular  Analyzer  data  base  with  respect  to 
the  spelling  of  the  names. 


Information 


The  report  presents,  for  all  those  names  used  as  input,  an 
alphabetical  listing  consisting  of  an  entry  for  each  name  as  it 
appears  as  input  and  entries  for  each  permutation  of  the  name 
(about  the  dashes) . For  example,  if  the  name 
hourly-em ployment-f ora  was  supplied  as  input,  there  would  be 
entries  for: 


employment-form  hourly 

form  nourly-employment 

hourly- employment- form 

in  the  report.  When  there  are  several  names  used  as  input  then 
all  names  with  the  word  "employment"  in  them  would  have  entries 
group  together,  all  those  with  "form"  would  be  grouped  together, 
etc . 


Format 

The  entries  in  the  report  are  ordered  alphabetically  and 
numbered  seguentially . There  are  two  parts  of  each  entry,  the 
right  hand  side  of  the  entry  presents  that  part  of  the  user 
defined  name  that  has  been  stripped  off  for  a permutation  of  the 
name  and  the  left  hand  side  of  the  entry  presents  the  remaining 
part  of  the  name.  The  distance  (the  number  of  columns)  between 
the  right  and  left  sides  of  the  entry  can  be  varied  by  the  value 
assigned  to  the  DIF  parameter. 


Options  and  A2 ter  natives 

The  DIF  parameter  may  take  on  any  value  from  2 to  52. 


Each  name  given  as  input  to  the  software  generating  the  report 
is  inspected,  separated  at  the  dashes  in  the  name  and  a list  is 
formed  consisting  of  the  original  name  and  all  permutations  of 
the  name. 

After  all  names  in  the  input  list  have  been  processed,  the  .trwlt 
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formed  list  is  sorted  and  presented  as  the  report. 


The  KWIC  INDEX  aids  analysts  in  maintaining  name  conventions 
used  in  the  tarqet  system  description  process  and  for  finding 
names  in  the  description  based  on  the  keywords  within  the  naaes. 

It  is  often  desirable  to  use  soae  conventions  in  assigning  naaes 
to  objects  defined  in  a target  systea  description  tna  the  KWIC 
INDEX  aids  in  maintaining  these.  For  example,  by  issuing  the 
following  Analyzer  coaaands: 

NAME-GEN  S*' ELEMENT' 

KWIC 


a KWIC  INDFX  is  presented  for  all  ELEMENT  names  so  that 
consistency  of  naming  can  be  checked. 


«&a»eles 

Fiqure  41  presents  a KWIC  INDEX  for  INPUT  naaes  defined  in  a 
problem  stateaent. 
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To  present  a list  of  all  conands  which  have  updated  the  data 
base  and  the  corresponding  date  and  time  as  they  appeared  on  the 
printed  output  for  each  update  command. 


This  report  present  a list  of  all  the  changes  that  have  been 
made  to  the  data  base.  The  list  contains  the  sequence  number  of 
the  change,  the  command  name,  and  the  date  and  time  when  the 
change  occurred  in  the  data  base. 


Format 

An  entry  in  the  report  is  printed  for  each  change  made  to  the 
data  base.  Each  entry  consists  of: 


- the  change  sequence  number 

- the  command  name  , 

- the  date  and  the  time  the  change  occurred, 

a 

This  information  is  listed  under  the  headings:  CHANGE,  COMMAND, 

DATE  and  TIME  respectively. 


±Dd  Alternatives 

The  PRINT  and  USSR  parameters  allow  the  user  to  direct  the  list 
of  data  base  char.qes  to  either  the  output  file  (PRINT),  the 
user’s  terminal  (USER),  or  both. 


Analysis 

All  UFA  modifier  commands  and  utilities  record  the  time  and 
incremental  sequence  number  of  the  data  base  modification. 
Specifically,  the  modifier  commands  FENAME,  CHANGE-TYPE, 
DLLETE-COMM  ENT-ENTh  Y , DELETE,  DELFTE-PSL,  INPUT-PSL,  and 
FLPI.ACE-COMMENT-FNTFY  add  a Date-of-Last-Change  record  to  the 
data  base.  The  utilities  PRES  and  PR23  also  add  a 
Date-of-Last-Change  record. 

When  the  LIST-CHANGES  command  is  issued  each  one  of  these 
Date-of-Last-Change  records  is  inspected,  and  the  information 
that  it  contains  is  retrieved  and  printed  on  the  report. 
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The  report  can  bo  used  to  keep  a record  of  the  changes  that  wtre 
made  to  the  data  base,  and  when  these  changes  wore  made.  The 
report  also  gives  an  indication  of  how  current  the  data  base  is. 

. The  LIST- CIIANC.ES  Report  can  be  used  in  con  junction  with  some 

other  reports.  The  date  and  time  of  the  last,  change  can 
optionally  be  printed  for  each  name  in  both  the  NAME-LIST  Report 
and  the  FOPN ATTFD-PhOHL  EM-FT  ATFH  VNT  report.  Names  can  also  be 
extracted  from  the  data  bane  based  on  their  date  ot  last  chanqe 
by  using  the  NAME-GF.NFF  ATICN  command  with  t h*»  HIN~CIIANC.V-  NUMPt  F 
and  N AX-CII A NGK- NUMHFF  parameters. 


JSlAUilll 

Figure  42  presents  a LIST-CHANGES  report  ot  a data  base. 

Figure  43  presents  a LI ST-CH ANGFS  Report  with  the  parameters 
NGPPINT  and  USSR  in  effect.  Note,  t hr,  teport  is  printed  at  the 
user’s  terminal  in  the  second  example. 


i 
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To  select  all  names  from  the  data  base  specified  by  parameters, 
""he  names  retrieved  will  be  placed  into  a file  in  a Format, 
suitable  as  input  tc  various  Analyzer  report  commands. 


Inf  orma  tion  Presented 

The  report  presents  a list  of  names,  their  corresponding  name 
types,  their  date  and  time  of  last  change,  and  the  name  of  the 
command  that  was  used  for  the  last  change.  The  names  may  he 
ordered  according  to  user  specifications.  The  types  of  names  in 
the  list  are  specified  by  the  selection  criteria  used  with  the 
SELECTION  parameter  described  below. 


Any  entry  in  the  report  is  printed  for  each  name  retrieved  and 
consist s of : 


- the  name  retrieved, 

- the  name  type  ot  the  name, 

- t.he  date  and  time  of  last  change,  and 

- th«?  command. 


The  entries  in  the  report  are  ordered  in  the  following  four 
ways : 


1)  alphabetically  on  the  names  within  a name  type  (which  are 
also  ordered  alphabetically)  when  the  OF DFF=uYT YPE 
parameter  is  in  effect. 

2)  alphabetically  on  the  names  when  the  OFDEF*ALPHA  parameter 
is  in  ef feet . 

l)  on  the  attribute  values  associated  with  specified  attribute 
names  when  user  attribute  names  are  specified.  The  output 
will  be  sorted  on  the  value  of  the  first  attribute  name, 
then  on  the  second  name,  etc.  Names  which  do  not  have  the 
specified  AT TRIP DTE  ace  placed  at  the  beginning  of  the  list 
of  names. 

4)  sorted  on  the  date  ind  time  of  last  change  when  the  OFPER* 
TIME-OF-LAST-CHANGE  parameter  is  in  effect. 

All  ORDEF  options  except  ALTHA  may  be  used  in  any  combination  in 
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the  list  of  parameters.  The  list  of  parameters  may  not  exceed 
five  options.  The  names  are  ordered  first  on  the  first  option 
in  the  ordering  list;  within  that  order  ing  or.  the.  second  option 
in  the  ordering  list,  etc. 


Options  and  Alternatives 

The  Selection  Criteria  paramater  permits  the  user  to  specify  the 
types  of  names  to  be  retrieved  by  giving  a boolean  expression. 
Either  the  SELECTION  or  INPUT  parameter  must  be  used  to  give  the 
boolean  expression.  If  SELECTION =' bool ean  expression'  is 
specified,  the  boolean  expression  appears  inside  guotes  or 
apostrophies  following  the  equal  sign.  It  INPUT=fdname  is  used, 
the  boolean  expression  must  be  in  the  file  specified  by  the 
user . 


The  names  retrieved  in  the  NAME  GEN  report  depend  on  the  items 
or  operands  given  in  the  boolean  expression.  Each  of  these 
operands  represents  some  grouping  of  names  which  may  be 
contained  in  the  data  base.  An  explanation  of  each  of  thes*1 
operands  is  given  below. 


The  following  name  types  may  be  used  as  operands: 


ATTFI BUTE 

ATTRIBUTE- VALUE 

CLASSIFICATION 

CONDITION 

ELEMENT 

ENTITY 

EVENT 

GROUP 

INPUT 


INTEPFACF 

INTERVAL 

KEYWORD 

MAILBOX- 

MEMO 

OUTPUT 

PFOBLEM-DEFINFR 
PROCESS 
PF OCHS EOF 


RESOURCE 

F ESC UFC £- US A GF-PAR A METER 

SECURITY 

SET 

SOUFCE 

SUBSETTING-CRITFRION 

SYSTEM- PAFAMETEP 

TRACE-KEY 

UNDEFINED 

UNIT 


ALL 

When  the  ALL  operand  is  specified,  the  names  of  all  r.ame  tynes 
except  SYNONYM  and  UNDEFINED  will  he  presented. 

TOTAL 

When  the  TOTAL  operand  is  specified,  every  name  in  the  data  base 
will  be  presented. 


BASIC 

When  the  BASIC  operand  is  specified,  the  basic  names  will  be 
included  in  the  output.  The  "Basic"  names  are  those  names  which 
are  not  SYNONYMS. 
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UNDEFINED 

When  the  UNDEFINED  operand  is  specified,  the  undefined  names 
mil  he  presented. 


ATTF  =at  tr-n  awe  [,  value] 

When  the  ATTF  operand  is  specifed,  those  names  with  the  given 
user-naae  as  an  ATIF I BUTS  are  selected  to  be  part  ot  the  output. 
The  user-naae  must  be  a name  defined  as  an  ATTRIBUTE  in  the  data 
base. 

If  an  ATTFI BUTE- VALUE  is  specified  as  part  ot  the  user  name  then 
only  those  names  with  the  given  user-name  as  an  ATTRIBUTE- VALUE, 
for  the  ATTRIBUTE  designated  by  the  ATTF  parameter,  are  selected 
to  be  par*  ot  the  output.  The  user-name  must  be  an 
ATTFIBUTE-VALUE  name  in  the  data  base. 


SUBPAFTS-OF  (SO)  = user-name[  , level  ] 

All  names  which  belong  to  the  StlPPAFTS  structure  for  a given 
name  (as  would  be  retrieved  for  the  STFUCTUFE  report)  can  be 
retrieved  by  specifying: 

SUBPAFTS-OF^name 

where  the  name  is  an  INPUT,  OUTPUT,  PROCESS  or  INTERFACE  name 
which  has  SUBPAFTS  information  defined  for  it.  The  number  of 
levels  to  go  down  and  retrieve  names  to  present  in  the  report  is 
specified  by  the  SUBLFVFL  parameter  or  by  attaching  a comma  and 
a level  number  after  the  user-name  with  the  SUBFARTS-OF 
parameter.  If  SUBLEV1'L  = ALL,  then  all  levels  of  names  are 
presented.  If  3UBLEVEL=1,  then  only  those  names  which  are  PAFT 
OF  the  SUBPAFTS  OF  name  are  presented.  The  following  picture 
may  clarify  the  association  between  the  value  of  SUBLEVEL  and 
the  names  presented. 

Si  SUBPAPTS-OF  name 

S 2 SI  SU  S(JBLEVFL  = 1 

S5  F6  S 7 SUELEVEL=2 

S8  S9  S11  S11  S UBLEVFL=  3 


SUBLEVEL=ALL 


Generation  of  the  report  with  SUPPAFTS-0F*S1  and  SUBLEVEL*3 
would  present  S2,  S3,  34,  S 5,  S6,  S7,  S8,  S9,  SID  and  S11  in  the 
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report.  Generation  of  the  report  with  SUDPAF TS-OF=S 1 AND 
SUBLEVEL*!  would  present  the  names  FT,  S?  and  S4.  If  neither 
the  level  nor  SUBLEVEL  parameter  are  specified,  the  default  is 
ALL  levels. 


SYNONYMS 

When  the  SYNONYMS  operand  is  specified,  all  SYNONYMS  are 
presented  for  each  name  retrieved  in  the  report  in  addition  to 
the  basic  form  of  the  name.  If  only  the  SYNONYMS  are  desired, 
the  basic  names  may  he  suppressed  by  specifying  the  NOBASIC  ard 
SYNONYM  parameters.  With  standatd  defaults  in  effect,  the  BASIC 
and  NOSYNONYM  parameters  are  used. 

MA X- CHANGE- NUMB EF  (M.AXC)  = (integer  | IASI  | LAST- integer) 

This  parameter  retrieves  all  names  with  a char.qe  number  less 
than  or  equal  to  the  specified  integer.  The  sequential 
change-number  is  incremented  every  time  the  data  base  is 
modified.  LAST-integer  should  not  result  in  a negative  value. 

MI N-CHANGE- NUhBSF  (MINC)  = (integer | LAST| L AST- inteqer) 

This  parameter  retrieves  all  names  with  a chanqe-number  qreater 
than  or  equal  to  the  specified  integer.  LAST-integer  should  not 
result  in  a negative  value. 


KEY  = user-name 

when  the  KEY  operand  is  specified,  those  names  with  the  given 
user-name  as  a KEYWOFP  are  selected  to  he  part  of  the  output. 
The  user- name  must  be  a name  defined  as  a KEYWOFP  in  the  data 
base . 


PD=user-name 

When  the  PD  operand  is  specified,  those  names  with  the  given 
user-naie  as  a PF03LEM-DFFINEF  are  selected  to  be  part  of  the 
output.  The  user-name  must  be  a name  defined  as  a 
PROBLEM- DEFINE F in  the  data  base. 


SO UPCE= user- name 

When  the  SOUFCE  operand  is  specified,  those  names  with  given 
user-name  as  a SOUFCE  will  be  included  in  the  output.  The 
user-name  must  be  defined  as  a SOURCE  in  the  data  base. 


SECURITY* user- name 
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When  the  SECURITY  operand  is  specified,  those  naves  with  given 
user-nave  as  a SECURITY  will  he  included.  The  user  nave  vust  he 
defined  as  SECURITY  nave  in  the  da'a  base. 


usage*  {in  1 1 denti  fiefi 

when  the  usage  operand  is  specified,  those  naves  which  are  usi  d 
as  IDENTIFIERS  in  the  data  base  are  selected  to  be  part  of  the 
output.  The  syntax  of  the  Language  only  allows  ELEMENT,  GPOUf 
and  UNDEFINED  naves  to  be  IDENTIFIERS. 

The  naves  retrieved  in  the  NAME  GEN  report  also  depend  on  the 
operators  which  are  combined  with  the  operands  to  form  fhe 
boolean  expression.  These  operators  further  define  grouping  of 
naves  when  combined  with  operands.  An  explanation  of  each  of 
these  operators  is  given  below. 


NOT,  - ,/ 

The  NOT  operator  placed  before  an  operand  specified  that  the 
naves  associated  with  that  operand  will  not  be  retrieved.  For 
example,  a boolean  expression  of  the  tori  NOT  PROCESS  veans  that 
all  names  in  the  data  base  except  for  PROCESS  naves  will  be 
retrieved . 


AN  D , 6 , * 

The  ANT  operator  specifies  that  any  name  retrieved  from  the  data 
base  vust.  meet  the  criterion  designated  before  a’nd  after  the  AND 
operator.  por  example,  a boolean  expression  of  the  form  PPOCFSS 
AND  KEY*ievel-1  means  that  any  name  retrieved  vust  be  a PPOCFSS 
name  as  well  as  have  he  KEYWORD  "level-1"  attached  to  it. 


OF,  !,♦ 

"■he  OP  operator  specifies  that  anv  name  retrieved  from  the  data 
base  iius'  either  meet  the  criterion  designated  before  the  OR 
operator,  or  after  the  operator,  or  both.  For  example,  a 
boolean  expression  of  the  form  PROCESS  OF  KEY*level-1  veans  that 
any  nave  retrieved  must  be  either  a PROCESS  nave,  or  have  the 
KF.YVOFP  "level-1",  or  be  both  a PROCESS  and  have  the  KEYWOFD 
"level-  1" . 


Analysis 

c.ach  name  defined  in  the  data  base  is  checked  aqainst  the 
parameters  for  the  command.  It  it  satisfies  the  requirements  as 
specified  by  the  parameters,  it  is  placed  in  a list.  After  all 
names  in  the  data  base  htve  been  checked,  the  list  is  sorted  as 
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will  be  printed. 

If  there  are  no  names  in  the  data  base  which  satisfy  the 
selection  criteria,  the  message: 

IJFA523:  G2TNML:  NO  MAKES  WHICH  MATCH  CFITEF  ION 

wi 11  he  printed. 

If  the  selection  string  given  as  input  is  not  a legal  boolean 
expression,  the  message: 

1JBA526:  NGPFS:  INVALID  SELECTION  STPING 

will  be  printed. 

If  the  selection  string  given  as  input  contains  an  illegal 
operand  or  operator,  the  message: 

UEA527:  NGPES:  INVALID  ITEM  IN  SELECTION  STRING 

will  be  printed. 

If  more  than  five  OFDEP  parameters  have  been  given  or  the  OPDER 
parameters  have  been  given  incorrectly,  the  message: 

(1EA528:  PFEPAR:  TCC  MANY  OFDEF  PAF AKETERS 

will  be  printed. 

If  the  name  given  in  the  order  list  is  not  an  ATTRIBUTE,  the 
message: 

URA529:  PREPAF:  NAME  IN  OFDFF  LIST  NOT  ATTRIBUTE 
will  be  printed. 

If  too  many  levels  have  been  specified  via  the  SUBPAFTS-OF  or 
SUBLEVEL  parameters  (a  fifty  levels  is  maximum) , the  message: 

UFA  535:  NGPFS:  TOO  MANY  LEVELS,  MAX  OF  50  ALLOWED 

will  be  printed. 

If  LAST-integer  results  in  a negative  number  the  message: 
UPA227:NGPPS: NEGATIVE  NUMUEF  ON  FIGHT  HAND  SIDF  OF  MAXC  OR  MTNC 
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will  he  printed. 


JJsa£e 


It  is  an  important  aid  to  the  analyst  in  obtaining  other  reports 
and  outputs.  For  example,  the  analyst  can  ash  for  a list  of  all 
SET,  ENTITY  and  GPOUP  names  and  with  this  list  then  ask  for  a 
CONTENTS  REPORT  for  these  names. 

It  is  also  used  by  the  analyst  as  a reference  to  what  names  have 
been  used  and  how  they  have  been  used  (i.e.,  what  their  name 
types  are)  . 

The  output  can  also  be  used  effectively  by  project  management  to 
measure  productivity  of  the  project  members.  This  can  be  done 
by  retrieving  a list  of  all  names  in  the  data  base  defined  by  a 
particular  problem  definet  (analyst)  and  comparing  it  to 
previous  lists. 


Finally,  the  NAME  GFN  output  can  become  an  integral  pafct  of  the 
final  specifications  as  it  acts  as  a directoty  in  specifying 
name  lists  corresponding  to  certain  selection  criteria  (a 
directory  of  all  data  elements  may  be  desired  before  a section 
which  deals  with  the  definition  of  each  element  in  detail). 


Examples 

Figure  44  presents  a NAME  GFN  report  produced  for  all  PROCESS 
names~wTIIch  have  "terminal"  defined  as  one  of  their  KEYWORDS, 

The  command  used  to  generate  this  example  was: 

NAME-GEN  S = ' K E Y =t er m ina 1 AND  PROCESS’ 

Figure  45  presents  a NAME  GEN  report  produced  for  all  names 
which  are  PROCESSES  and  which  do  not  nave  "terminal"  defined  as 
one  of  their  KEYWORDS.  The  command  used  to  generate  this 
example  was: 

NAME-GEN  S= ' PROCESS  * NOT  KE Y=terminal • 

Figure  46  presents  a NAME  GEN  report  produced  for  all  names  , 

whicTPhave  the  ATTRIBUTE  occurrence- type  with  the 
ATTR IBUTE- V AL'JE  unscheduled.  The  command  used  to  generate  this 
example  was: 

NAME- GEN  S = * ATTP  =occur rence- type, unscheduled* 

U 

Figure  47  presents  a NAME  GEN  report  produced  for  all  INPUT  and 
OUTPUT  names  which  have  the  ATTRIBUTE  copies  or  arrival-type 
with  the  ATTRIBUTE- VALUES  3 or  random.  The  command  used  to 
generate  this  example  was: 


287 


i" 

o 


CM 

o 


a. 

-CHANGE 

co 

w 

m 

i/l 

»» 

K 

<n 

►4 

u 

1 

• • 

x 

o« 

o 

r- 

i 

M 

S3 

r~ 

M 

r- 

H 

CTi 

O 

r- 

Z 

% 

« 

w 

tL 

i— 

X 

f-l 

0. 

X 

10 

CQ 

cn 

II 

u. 

i<4 

& 

it. 

o 

• 

a 

U) 

o 

in 

•rl 

im 

it 

V 

u 

it 

3 

o 

1 

w 

14 

0) 

U4 

cr. 

c 

O 

1) 

a 

O 

o 

z: 

M 

•c 

ft. 

a- 

e 

r—4 

(0 

(tJ 

* 

C 

w uiin  i/i  w in  w w n '/)  w w w m 
MinwwwwMinwwwwiiiin 
W ;'j  f<4  :J  W U W W U]  4 tq  „l  fq  q 
UUUUUUUUUUUUUU 
OO  OOUOOCOOOOOO 
n.  u:  u,  u,  u.  is  u.  u,  «,  w.  a.  o.  w,  n. 

UilSUiliiUiUiUlliiUlliMiUlUlUl 


B 

l~l 

0) 


II 

X 


U 

o 


U4 

c 

fC 

a» 

o 

4-> 

• 

P 

•H 

<d 

II 

e 

+-' 

3 0) 

4^ 

c 

Lfl 

*9 

a> 

o 

3 

O LJ 

9 

o 

o 

Q.  4-> 

•<H 

TJ 

•3  3 

04 

•H 

M 

3 

3 

L> 

•H 

+J  TJ 

a 

E 

»-> 

1 

TJ 

3 

C -H 

3 CL 

o 

O 

3 

t— 

U 

UI 

CL 

V 

O 3 

4-<  3 

•H 

O 

L> 

M 

<2 

a 

3 

•H  &• 

3 1 

P 

1 

3 

IO 

.-4 

O 

l 

01  CL. 

V 1 

CL  UJ 

«J 

w 

Cl 

• 

U4 

•H 

in 

«J  H 

3 C 

a e 

a ns 

c 

B 

ro 

t/J 

4 J 

a 

3 O 

V O 

o o 

O *H 

o 

U 

o 

O 

TJ  O 

3 --I 

U *H 

•H  «— 1 

•H 

u 

55 

X 

a 

•H 

Q> 

CL  1 

0) 

CL  *J 

1 L 

p (d 

4J 

1 

o 

K 

*a 

4J 

*> 

3 X 4J 

B 3 

X o 

fd  > 

0 

UJ 

M 

C3 

w 

o 

3 

1 3 

«J 

O V 

3 3 

^ i 

9 

u 

<n 

Z 

#1 

' a 

3 3) 

X O.TJ 

U 3 

clt: 

3 TJ  TJ 

3 

iu 

W 

I 

TJ 

a.  3 i 

CL 

1 CL  1 01 

CL  M 

0) 

o 

M 

• • 

H 

0) 

3 

CL  I/I 

3 

X ■ 

UJ  TJ 

H 3 TJ 

js 

> 

04 

X 

m tj 

1 

i m 

1 

3 O 

M 1 

O O 

1 

1 

O 

u 

w 

i 

U> 

uj  o 

UI 

CL  O 

O 01 

O S 

r— ( 

f*-4 

(i4 

u* 

U) 

3 TJ 

tfl  M 

U 

1 1 

14  «J 

1 01 

(T? 

<d 

Ui 

cr 

T* 

u 

c 

o en 

3 

V X t7>  3 

x a 

4-> 

S3 

cn 

a. 

0) 

•H 

9 

U | 

O 

01  3 

1 *J 

<d  *h 

O 

o 

04 

<44  <4-1  <44 

rr  -c 

J= 

C Cl.  10  10 

4J  4J 

•P 

p 

14 
l ' 
W 
M 

«< 

Itt 

«< 


l- 

S”. 


It. 

On 


r N n ^iniOMDO'0»*lN")4 


v<r* CTjH&v.  w 


w-wwii.  w-hm 


00 

c» 


ul 

o 

< 

CU 


u 

«n 

it 


O 


• • 
kN 


r- 

r- 

o 


CU 

H. 

10 


'5 

SO 

< 

3] 

0 
< 

1 

to 

►4 

I 

fu 

0 

1 

W 

»: 

* t 
f < 

o 

so 

U< 
ll. 
►* 
) < 
>« 
ai 
it 

• U 
1.1 
(4 
.U 

O 


u! 

O kS 

rl  itJ 


ui  *j  <: 

t <0  rl 

I Is  U 


»*4 

u 

10 

to 

to 

to 

to 

01 

W) 

'll 

01 

10 

til 

ui 

01 

to 

01 

01 

01 

ui 

0) 

10 

IO 

to 

05 

>0  10  IO 

01 

«n 

10  oi 

3 

c 

Ul 

i; 

a« 

•o 

IO 

01 

to 

01 

Ul 

10 

to 

01 

to 

01 

01 

I/I 

in 

01 

to 

to 

01 

t/l 

ui 

to 

10 

01 

OI 

10 

01  Ul  01 

01 

01 

oi  to  t/i  oi 

Ul 

rj 

a> 

p 

iii 

.41 

.0 

••) 

III 

M 

111 

111 

111 

Ul 

0 

III 

l.l 

.1  III 

kl 

III 

III 

111  ,0  III 

.■l 

HI 

4 

111 

1*1  Hi  1*4 

.4 

M 

4 *«1 

14  111 

1“ 

t* 

o 

M 

u 

y 

u 

u 

u 

u 

u 

u 

u 

u 

u 

tj 

u 

u 

u 

t > 

u 

u 

u 

u 

u 

u 

u 

u 

u 

u u u 

u U 

u u 

O (1 

O 

i * 

0- 

Cl 

o 

o 

o 

<J 

o 

c- 

o 

C) 

u 

c> 

c> 

u 

c> 

o 

o 

c> 

o u 

o c> 

o 

o 

o 

o 

o c<  o 

o 

a 

o o 

O O 

o 

IV, 

w 

lu 

.u 

Ui 

It! 

III 

III 

l». 

III 

Ui 

O* 

Ul 

IU 

u. 

ill 

IU 

IU 

\u 

u. 

u« 

u. 

IU 

IS. 

lU 

II.  IU  |l. 

M. 

Im 

III  III 

Hi  Hi 

Mi 

« 

Ifl 

ar 

.V 

t • 

O 

in 

Ul 

SU 

in 

IS. 

is. 

is. 

is. 

ih 

u. 

u. 

IS. 

Ul 

u* 

u. 

IS# 

IU 

u. 

tu 

is. 

u. 

IS. 

IU 

u.  is.  is. 

P« 

U4 

su  Ml 

IU  IU  |s» 

.4 


u 

I« 

O' 

ui 

O 

CJ 

O 

M |3 

ul 

o 

a 

13 

ll 

Ui 

rl 

•H 

O O 

o 

II* 

•r4 

IP  O 

O 

c t: 

•4 

S 1 

*/ 

•rt  -kl 

D> 

C*4 

c 

ll  -1 

*i  4 

o o 

ui  to 

ItJ 

V 

*1  ♦' 

a 

■» 

u 

(1 

o 

iTJ 

.1  *> 

»» 

■H  ‘W 

O 10 

1) 

n 

1'  Itl 

If 

ki 

a 

H 

o 

O <-t 

‘H 

14 

W5  UJ 

*'  ♦' 

tr 

•H  O' 

ll 

O' 

O *tJ 

is 

to 

o r*- 

i>* 

U H 

rl  ID 

M 

iU 

iO  4» 

f-4 

U ItJ 

u. 

M U 

0 

’O 

TJ  -rl 

4' 

to 

H U 

Q 

O *1 

S'  > 

Ul 

C 

4'  li 

3 TJ 

•H 

ItJ  O 

1 

t 

(j 

O kS 

M 

O' 

SJ  rl 

1 4 

ll  *4 

H O 

11 

U‘ 

u 

tl  U 

«T1 

T>  ‘.1 

to 

u u 

il 

IS  ItJ 

o 

V 

o 

ui 

m to 

i* 

n.  u 

tj  r 

O' 

r4 

O I 

11  ul 

9 

0 kS 

05 

tv  v a. 

o 

o 

c».  ► 

o 

*r  4 

w- 

o 

O 

t-rl  m 

w 

»J 

t *4 

*r)  is. 

ll 

i 

U) 

oi 

u oi 

01 

tTI 

ui  4-1  1 

.1 

i 1 

o 

4 * 

• 

ll 

rl 

ui 

D 4 

M 

11  IS 

(it  l« 

o. 

>.  V) 

a» 

o.  o 

O 

o.  > 

u 

a 

41  V 01 

s> 

.V  M 

ll 

jk  a. 

X 

.1 

u o 

*> 

. 1 

0 •.! 

J<  1 

rr 

14 

Oi 

4' 

1 .1 

t I 

0 

‘rl 

rn-o  oi 
| o.  ►. 

V 

0) 

o u 

a.  o 

u 

• 

U 

S' 

kS  o 

• 

• 1 

u u 

1 

4-' 

u 

Oi 

M .V 

Is 

to  ► 

• 

M 

V V 

i 

H 

*J 

a.  s« 

0 

to 

« US 

m 

IO 

is  01 

kS  r-S 

fe- 

rs 

o 

o 

O'  itJ 

O U 

HI 

ts. 

to  IS 

►-DO 

M 

ts 

j;  x 

M 

«44 

c 

m 

•H 

U 

•ll 

u a. 

V ► 

>rl  ‘rl 

ll 

D 

w 

a. 

V ft 

fl 

‘1)  01 

•o 

• 

O'  «t 

ll  1 H 

x Cs.  a. 

o 

C 

O U 

O 

•r4 

V 

vl> 

rr+ 

Is 

rS 

L t 

{•*, 

>- 

u 

IU  <SS 

9 

u 

0 

o w 

M 

sJ  X 

o. 

u> 

u n 

41 

4S 

►*  ► 

u 

u 

1 

1 

V 

O 

• 

O 

l • 

• | 

c 

4-* 

1 

is. 

-s  o 

O 

0 o 

0 

O' 

o xt 

BUM 

UJ 

U 

(tJ  it) 

M 

4) 

X 

<r 

0 

U 

a a 

i i 

i* 

• H 

V u 

n 

14 

a. 

IS.  k|  1 

V4I 

►.  v* 

is.  S' 

IS  -rl 

41  O'  O' 

•H 

*H 

n.  a 

O' 

> 

is 

U 

1 

1 

o 

rl  -rl 

*/! 

>: 

*rl  »H 

u e. 

• 

O 

m 

N 

u u 

a 

(0  Itl 

0 

an 

• • ± 

1 

1 

i l 

1 

9 

o 

•H  T* 

Tl 

H 

R ■ 

W« 

i«i 

♦ ' X 

oi  a> 

♦> 

tO.  o> 

41 

<v>  -H 

cs.  a.  m -ri 

0)  .4 

i l 

Hj  it* 

TJ 

TJ 

<V  TJ 

i' 

O 

a 

4 ’ 

IS 

IS 

♦J 

O'  O' 

t»l 

•• 

1 1 

■ m 

u 

O' 

1 

• 

1 1 

I 

i i 

O' 

P 

CS.r-t  « 

U V V 

O' 

O' 

O'  V 

IP 

V 

It 

ItJ 

If 

u 

11  is 

n« 

•n 

• 4 »-l 

v *-> 

o 

Is 

►- 

t»i 

>i  >1 

1 ItJ 

o 

II 

n to 

0 *rl  rt 

H 

■ H 

•H  .il 

H 

*H 

Is 

u 

O 

u 

a.  is. 

o 

ItJ  (tj 

IS  ss 

a. 

1 

r-4 

-<  rS 

—4 

r-t  kS 

V)  M 

i 

O' 

O V 

a.  is  is 

U 

ll 

M U 

♦ ' 

4^' 

l 

'H 

1 

1 

tX 

1 i 

•V 

•r. 

n 3 

UJ  Tt 

i> 

a» 

Is 

11 

Ul  Is 

94 

is  M 

H 1 

ll 

1 

u y 

4'  0*  O' 

OJ 

01 

V Tl 

t 

I 

V 

01 

4' 

V 

c 

II 

er 

*J  *> 

o.  a. 

u 

is 

n 

O 

D rs 

0 

a a 

El  XI 

■ 

> 

►*  0 

is  n n 

' — 1 

n 

HHU 

is 

14 

0 

■ 

to 

0>  0> 

n 

♦0 

Oi 

O U 

oi  a* 

l 

o 

o 

O 0 

O 

o 0 

0 0 

to 

IV 

to  M 

1 in  «» 

V 

w 

W fit 

4» 

4-‘ 

V 

O' 

*r4 

kl 

ll 

<t»  P? 

Mi 

HI 

• -4 

m tr 

Hi  <n 

S3 

JR 

r. 

a 

s.  xt 

m 

.ft  X 

X T' 

a 

B 

D.  a 

to  ui  to 

to 

to 

to  to 

to 

in 

S' 

4> 

4' 

!■' 

S-' 

> ) 

t « 

Ul 

>: 

‘-T. 

» 4 

Ul 

-< 

r*  4 

i»4  * 

If! 

>u 

r 

<p  . j 

T“ 

,\1  r»i 

4 IO  'O  fi 

n)  in  <~t  *-  rn 

in 

3 

in.on 

cr> 

F“ 

I'l 

n> 

^ in 

ui 

r- 

F- 

r-  T- 

r*-  f- 

r- 

r »• 

ro  <N  <N 

>N 

C4  IN  IN  IN 

N ro  "l  if 

i-l 

fv>  in 

•< 

rv 


UFA  User's  Manual 


291 


NAME-GEN  S«  * { IN  PUT  |0  IITPUT)  G l A TTF  -copies,  3 | 
arrival-type, random) • 


used  to  generate  this  exa»ple  was: 
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NAME-GEN  SB,,KIN- CHANGE- NUMBER*  LAST" 


Part  III  hca  outputs 


*--r  « **V 


* 


wmmnmmmm 


cm 


It 


UFA  Dsor's  Manual 


liifll  ilfi 


11  tv 


» 

293 


£H£J&S£ 

To  present  a list  of  all  names  defined  in  a particular  Analyzer 
data  base.  The  list  may  optionally  contain  the  name  type 
associated  with  the  name,  SYNONYMS  defined  for  each  name,  and 
the  date  of  last  change  of  each  name. 


Information  Presented 

The  report  presents  every  name  currently  defined  in  the  user's 
data  base,  and  also  may  present  the  name  type  associated  with 
each  name,  the  SYNONYMS  associated  with  each  name,  and  the  date 
of  last  change  for  each  name. 


12£M± 

An  entry  in  the  report  (all  the  options  in  effect)  is  printed 
for  each  name  in  the  Analyzer  data  base  and  consists  of: 

- the  name, 

- the  name  type  of  the  name, 

- any  SYNONYMS  for  the  name,  and 

- the  date  of  last  change  tor  that  name. 

The  entries  within  the  report  are  ordered  in  one  of  two  ways: 
alphabetically  on  the  names  when  the  GFDEF*ALPHA  parameter  is  in 
effect  and,  alphabetically  on  the  names  within  name  type  (which 
are  also  ordered  alphabetically)  when  the  OFDE  F =BYTY  PE  parameter 
is  in  effect. 

If  no  SYNONYMS  are  available  for  a particular  name  a dash  (-)  is 
printed  under  the  SYNONYM  heading.  If  more  than  one  SYNONYM 
exists  for  a name,  they  are  listed  beneath  each  other. 


and  AiisinaLiies 

The  options  ORDER=ALPHA  and  ORDFF=BYTYPE  are  available  for  this 
report.  If  the  option  COLUMN5 SYNONYM  is  specified,  the  SYNONYM 
coluan  will  be  printed  to  the  left  of  the  TYPE  column.  If 
COLUMN^TYPE  is  in  effect,  the  TYPE  column  will  be  printed  to  the 
left  of  the  SYNONYM  column.  In  addition,  the  parameters: 

NOTYPE,  NOSYNONYM,  NODATF-LAST-CHANGED  suppress  the  printing  of 
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the  TYPE,  SYNONYM,  and  DAI L- L AST-CHANG L respectively,  fot  each 
name  in  the  list. 


Each  name  in  the  data  base  is  inspected  and  its  name  type  and 
any  SYNONYMS  for  the  name  are  retrieved.  After  this  information 
has  been  collected  accorliny  to  the  ORDER  parameter  for  all 
names  in  the  data,  it  is  sorted  and  presented  as  the  report. 


Usage 

The  report  is  intended  to  be  used  as  a directory  facility  by 
anyone  needing  a reference  including  all  names  defined  in  the 
data  base. 


IxajLEl^ 


Figure  U9  presents  the  NAME  LIST  report  generated  with  the 
OFDER*BYTYPF  and  NODATS- LAST-CH ANGED  options  in  effect.  Figure 
50  illustrates  the  NAME-LIST  report  with  the  0EDF.h=  ALPHA,  COLUMN 
and  DATE- 1, AST- CHANGED  parameters,  ’’'he  commands  used  to 
generated  these  examples  were: 

NAME-LIST  OFDSF=BYTYPF  NODATE-LAST-CHANGED 
NAME-LIST  0 RDER  * ALPH  A COL=SYN  DLC 
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Purpose 

The  PICTUPE  report  presents  flow  and  structure  information  about 
the  problem  statement  in  a qraphical  format,  "he  PICTURE  report 
provides  the  user  with  a detailed  view  of  one  part  of  the  target 
system  description  (i.e.,  it  preser’-s  all  flow  and  structure 
relationships  a particular  name  has  with  other  names). 


Information  Presented 

The  PICTURE  report  can  be  produced  for  any  names  in  the  data 
base  of  the  following  name  types: 


INTERFACE  SET  INPUT  OUTPUT 

ENTITY  CROUP  ELEMENT  PROCESS 


The  information  presented  in  the  report  varies  depending  on 
which  name  type  the  report  is  produced  for  and  the  parameters 
used  when  generating  the  report.  For  each  name  type  the  FLOW, 
STRUCTURE  and  DATA  parameters  present  different  types  of  UFL 
relationships  as  retrieved  from  the  data  base.  Table  7 shows 
the  relationships  presented  for  each  name  type. 


The  PICTURE  report  is  jenerated  in  a graphical  format.  The 
basic  template  for  the  format  is  shown  in  Figure  51.  A given 
PICTURE  report  describes  a single  named  object. 
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Figure  51 

General  FICTUPE  Format  and  Limits  per  Paqe 

The  object.  being  described  is  represented  by  a retar.gular  box 
printed  in  the  center  of  the  report  paqe.  All  named  objects 
related  to  the  center  object  are  also  represented  by  rectangular 
boxes  but  are  arranged  around  the  perimeter  of  the  paqe.  The 
name  type  (PROCESS,  ELEMENT , etc.)  of  the  represented  object  is 
printed  along  the  top  line  of  each  box.  The  relationship  of  an 
object  (represented  by  one  of  the  perimeter  boxes)  with  the 
center  object  is  printed  along  the  bottom  line  of  the  box.  For 
illustrative  purposes,  lines  extend  from  each  box  to  the  center 
box. 
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The  preceding  example  is  to  be  interpreted  as  follows: 

PFOCFSS  pr-x  USES  GROUP  gr-Z  and, 

PF0CFF5  pr-x  DZFIVFE  ELLMENT  el-y. 

Should  a PICTURE  ot  particular  name  exceed  the  paqe  limitation 
as  qiven  in  Figure  5i  the  PICTURE  will  be  continued  on 
succeeding  pages. 

The  format  of  the  relationships  presented  varies  depending  on 
the  name  type  of  the  ob-ject  being  described  (lust  as  the  types 
of  relationships  vary).  The  remaining  figures  in  this  section 
show  how  relationships  are  formatted. 
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Options  and  Alternatives 


The  user  has  the  option  of  displaying  any  combination  of  the 
three  types  of  relationships  {DATA,  FLOW  and  STFUCTUFE)  on  the 
report.  See  Table  7 for  which  relationships  are  displayed  in 
each  of  these  categories  tor  a particular  name  type.  For 
example,  if  only  the  CONSISTS  and  CONTAINED  information 
(STRUCTURE)  were  to  be  displayed  for  a particular  ENTITY  name, 
DATA  and  FLOW  relationships  could  be  suppressed  via  the  NOD A TA 
and  NOFLOW  parameters.  The  parameters  allowed  and  their  effect 
on  the  report  are  described  belcw: 

1)  DATA  - specifies  that  data  type  relationships  be 

included  in  each  FICTUfF. 

NODATA  - specifies  that  these  relationships  are  not 

included  . 


2)  FLOW 

NOFLOW 


specifies  that  flow  type  relationships  be 
included  in  each  FICTufF, 

specifies  that  *hese  relationships  are  not 
included . 


3)  STPUCT'JFE  - specifics  that  structure  type  relationships 

be  included  in  each  PICTURE. 

NCSTFUCTUF E - specifies  that  these  relationships  are  not 
included . 


An  INDEX  for  the  report  is  produced  when  the  INDEX  parameter  is 
used. 


The  report  may  be  generated  for  a single  input  name  (via  the 
NAM2  parameter)  or  for  a collection  of  names  either  specified  by 
the  USEP  or  retrieved  via  NAKF-GFN. 


Mails  is 

For  each  name  given  as  input  the  software  finds  the  name  in  the 
data  base.  If  the  name  is  not  found  the  message: 

UE  A Ob  6 : MAINP1C:  NAFF  NOT  IN  D.P.  - 

is  printed.  If  the  name  is  found  it  is  checked  if  it  is  of  a 
legal  name  type  for  which  a PICTURE  may  be  generated,  i.e.,  a 
SKT,  INPUT,  OUTPUT,  ENTITY,  GROUP,  ELEMENT,  PFCCESS,  or 
INTERFACE  name.  If  it  is  not  one  of  these  name  types  the 
message: 


1IFA0b7:  KAINPIC:  PICTUFE  NOT  AVAILABLE  FOF  - 

is  printed.  If  the  name  is  of  a legal  name  fype  it  is  then 
checked  if  any  of  the  relationships  that  can  be  presented  in  the 
PICTUFF  for  that  name  type  exist  tor  the  particular  name.  If 
none  of  these  relat.  ionsh  ips  exist,  the  message: 
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UPA2P9: PCLPBI:  NO  PICTUFE  AVAILADLE  FOF 

is  printed.  Otherwise,  those  relationships  available  for  the 
name  are  presented  ir  the  report. 


Usage 

Project  management  can  use  this  report  to  gain  a basic 
understanding  of  the  functions  of  the  tarqet  system  by  viewing 
PICTUFES  of  high  level  ♦arget  system  objects. 

riCTUFES  provide  a qood  means  of  communicat ion  among  people  in 
the  project  and  those  external  to  it.  A graphical  format  is 
often  easier  to  interpret  than  a matrix,  narrative  text,  etc. 

Problem  Definers  may  use  the  PICTUFF  report  to  visually  analyte 
the  description  of  particular  objects  to  check  tor  completeness. 
For  each  tvpe  of  name  (e.g.,  PROCFFS  or  ELEMENT)  several  checks 
can  be  made  depending  on  the  relationships  presented  in  the 
report.  Table  n presents  completeness  checks  that  can  be  made 
by  visually  scanning  PICTUFE  reports. 


Examples 

Fiqure  59  presents  a PICTUFE  for  an  INPUT  name  "time-card." 

Figure  f.O  presents  a PICTUFE  for  an  INTEF FACE  name  "employee." 

Figur  61  presents  a PICTUFE  for  a PROCESS  name  "hourly- 

employee-  processing . " The  examples  above  were  produced  by 
givinq  the  following  Analyzer  commands: 

PICTUFE  NAM E=time-card 
PICTURE  NANE=emplovee 

PICTUFE  NAMI =hou r 1 y-em pi oyee- processing 
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NAME  TYPE. 

FFIATIONSHITS  DT  SPLAY  FT 

INTERFACE 

FLOW 

- RECEIVES 

GENERATES 

STF  UCTUKE 

- PA  F T OF 

SUBPAFTS  ARE 

P A TA 

••  RESPCNSIDLE  FOR 

SET 

FLOW 

• DERIVED 

UPDATED 

USED 

STRUCTUpF 

- SUBSET  OF 

SUBSETS  ARE 

CONSISTS 

DATA 

- RESPONSIBLE-INTERFACE 

SUPSE7TING-CFITEFIA 


IN  TUT 


FLOW  - GFNF FATED 

DECEIVED 

USED 

STRUCTURE  *■  PART  OF 

SURPASS  AFK 

CONTAINED 

CONSIST? 


OUTPUT  FLOW  - C.tNEFA^FD 

DF  RI VED 
RECEIVED 

STFUCTDFF  - PA  FT  OF 

SUBPAFTS  ARE 
CCNTAI NED 

consists 


^LOW 

- DERIVED 

UPDATED 

USED 

STF  UCTIIF  F 

- CGNTAINLD 

CONSISTS 

DATA 

- IDENTIFIED 

Tahir  7. 

Nano  Ty poo  and  Folat  ior. ships  Prosont.ed  in  PICTURE  Roport 
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NAME  TYPE 

RELATIONSHIPS  DISPLAY 

GPOUP/ELEM  ENT 

FLOW 

- DFRIV-C 

UPDATED 

USED 

USED  mO  DFFIVF 

USFD  TO  UPDATE 

STRUCTUF  F 

- CONTAINED 

CONSISTS  1 

DATA 

- ASSOCIATED 

IDENTIFIED 

SUDS  ETT  INC.- CRITERION 

PROCESS 

FLOW 

- RECEIVES 

USES 

USES  ro  PEF.IVF 

USES  TO  UPDATE 
DERIVES 

GENEFATFS 

UPDATES 

MAINTAINS 

STFUCTUF  E 

- PART  OF 

SIIDPASTS  AFE 

UTILISED  PY 

UTILIZES 

Table  7 (Continued) 


1 This  relationship  only  applies  to  GROUPS,  i.e.,  an  ELEMENT 
cannot  CONSIST  of  anything. 
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INTERFACE 

An  IN??. P FACE  should  FLCEIVE  an  OUTPUT,  GENERATE 
an  INPUT  and/or  be  RLSPONSiniE  for  a SIT. 

SET 

A SET  should  be  USED  by  a PROCESS,  DERIVFD  by  a 
PROCESS,  and/or  be  UPDATED  by  a PROCESS. 

A check  can  also  be  made  that  the  SET  has  a 
KESPONSIULF-INTFFACE. 

If  the  SET  has  SUBSETS,  it  should  also  have 
SUSSEX TING-CFITEFIA. 

INPUT 

An  INPUT  should  be  RECEIVED  by  a PROCESS  and 
GENERATED  by  an  INTERFACE.  An  INPUT  shoul! 
also  be  DERIVED  by  a PROCESS. 

OUTPUT 

An  OUTPUT  should  be  GENEFATED  by  a PROCESS  ar.d 
RECEIVED  by  an  INTERFACE.  An  OUTPUT  should 
also  be  DERIVED  by  a PROCFSS. 

ENTITY 

An  ENTITY  should  be  USED  by  a PROCESS,  DERIVED 
by  a PROCESS , and/or  be  UPDATED  by  a PFOCFSS. 

A check  can  alsc  be  made  that  the  ENTITY  is 
IDENTIFIED  by  a GROUP  or  ELEMI NT . 

GFOUP/EL3M2NT 

A OF  OIJ  D/EL  ZMFNT  should  be  USED  by  a PFOCESS, 
DERIVED  by  a PFOCFSS,  and/or  be  UPDATED  by  a 
PROCESS. 

A check  car.  be  mad-?  that  the  GROUP/ELEMENT  may 
IDENTIFY  an  ENTITY,  be  SUBSET7ING-CPITERI0N  for 
a SF I and/or  be  ASSOCIATED  with  a RELATION. 

PROCESS 

A PFOCFSS  should  FECEIVE  an  INPUT,  GENERATE  an 
OUTPUT,  USE  a SET,  ENTITY,  INPUT,  GROUP  or 
ELEMENT , DFPIVF  a SET,  OUTPUT,  ENTITY,  GROUP  or 
ELEMENT,  UPDATE  a SET,  ENTITY,  GROUP  or 

ELLMENT,  and/or  MAINTAIN  a RELATION  and/or 
SUBSETTING-CFITFPJON 

TaMf  8. 


Completeness  checks  that 

by  the 


may  be  made  by  the  PICTURE  Report 
PICTUFF  Report. 


Part  III  UFA  Outputs 


■SUWJB. 


UFA  User’s  Manual 


33S 


P£2CF^5  CHAIN  REPORT 


£ui£aJQ 


To  present  in  a graphical  format  the  sequence  of  LVENTS  and 
PROCESSES  which  occur  as  a result  of  each  EVENT  or  PROCESS 


specified  as  input. 


Information  Presented 


For  each  EVENT  name  cjiven  as  input  *-o  the  software  or 


encountered  during  the  analysis,  the  report  presents: 


1)  All  PFOCESS  names  which  the  EVENT  TRIGGERS,  TERMINATES  or 
INTERRUPTS. 


2)  All  EVENT  names  which  the  EVFNT  CAUSES. 

Similarly,  for  each  PROCESS  name,  the  report  presents: 


D 


All  EVENT  names  occurring  ON-INCEPTION  or  CN-TERM I NATION  of 
the  PROCESS. 


2)  All  PROCESS  names  which  the  PPOCESS  TRIGGERS,  TERMINATES  or 
INTERRUPTS. 


Starting  with  a name  given  as  input  (either  a PROCESS  or  an 
EVENT) , the  analysis  is  repeated  for  lower  levels  and  the 
network  continues  until  a name  used  previously  is  encountered  or 
no  more  relationships  are  found. 


. ' 


\ 


120  at 

Each  name  which  appears  on  the  output  is  shown  within  a box. 
the  top  line  of  the  box  indicates  the  name  type  (EVENT  or 
PROCESS)  where  the  bottom  line  shows  the  relationship  with  the 
preceding  EVENT  or  PROCESS  (TRIGGEFFP,  CAUSED,  ON-INCEPTION, 
ON-TEPMINATION , TERMINATED,  INTLF P UPTLD) . The  report  will 
indicate  whether  these  dynamics  relationships  are  conditional 
(DEPENDING  ON)  or  repetitive  (FOR  EACH)  if  the  options 
requesting  this  information  are  used.  Boxes  containing  the 
related  names  are  linked  by  dotted  lines. 

If  a name  joins  two  or  more  chains  (strings  of  related  names) 
into  into  a loop  or  loops,  every  appearance  of  that  name  after 
the  first  will  be  followed  by  the  message,  "NAME  OCCURS 
ELSEWHERE.  SEE  INDEX.". 
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Output  is  continued  across  page  boundaries.  If  the  right  edoe 
ot  one  page  continues  to  the  left  edge  of  a second,  the  riqht 
most  column  of  boxes  on  the  first  page  will  be  repeated  as  the 
left  most  column  of  boxes  on  the  second  paqe,  in  order  to 
facilitate  Matching  of  edges.  Similarly,  if  the  bottom  edge  of 
one  paqe  continues  to  the  top  edge  of  a second,  the  bottom  row 
of  boxes  on  the  first  page  will  be  repeated  as  the  top  row  of 
boxes  on  the  second  page. 


Options  and  Alternatives 

The  report  may  be  generated  for  a single  EVENT  or  PROCESS  race 
(via  the  NAME  parameter)  or  for  a collection  of  such  names, 
either  input  by  the  user  or  obtained  from  a FI1E. 

The  number  of  columns  and  rows  used  on  the  paqe  may  be  decreased 
from  their  default  maximum  values  of  119  and  i9,  respectively, 
via  the  COLUMNS  and  ROWS  parameters.  The  minimum  acceptable 
values  for  COLUMNS  and  FCWS  are  39  and  19,  respectively. 

The  HORIZON  T A L- POXES  and  VEF  TICAL-  POXES  parameters  specify  the 
number  of  boxes  arranged  horizontally  and  vertically  on  a pane. 
The  default  value  assigned  to  these  parameters  is  the  maximum 
number  of  boxes  that  could  appear  between  the  given  COLUMN  and 
ROW  settings.  For  example,  if  C0LUMNS=119  and  ROWS=39  (their 
defaults)  are  specified,  then  the  values  for  HOPIZONTAL-POXES 
and  VERTICAL- BOXES  will  default  to  6 for  both.  Values  for 
HORIZONTAL-POXES  and  VSR TICAL- BOXES  that  are  less  than  default 
will  result  in  pictures  that  are  spread  out,  that  is,  there  will 
he  a greater  distance  hetween  boxes.  Due  to  the  scheme  for 
continuing  pages,  *-he  minimum  value  that  can  be  assigned  to 
HOPIZONTAL-POXES  and  VERTICAL- BOXES  is  2 for  both. 

The  number  of  connections  that  are  to  be  traced,  starting  at  the 
given  name,  may  be  set  at  any  positive  value  via  the  LINKS 
parameter.  The  same  LINKS  value  is  used  for  all  names  input 
when  the  FILE  parameter  is  used. 

An  index,  containing  each  name  used  on  the  report  and  the 
page(s)  on  which  it  appears,  may  be  obtained  by  specifying  the 
INDEX  parameter. 


Maiisjs 

Each  name  given  as  input  is  first  chocked  to  see  that  it  is  in 
the  data  base  and  that  it  is  either  a PFOCESS  or  EVENT  name.  If 
the  name  is  not  in  the  data  base,  the  message: 

URA391:  FIIEAT : NAME  NOT  IN  DATA  BASE 

will  be  given.  If  the  name  is  of  a type  other  than  PPOCFSS  or 
EVENT,  the  user  will  receive  the  message: 
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UFA  192:  FILMAT:  NAME  NOT  EVENT  OR  PROCESS. 

If  the  name  is  in  the  lata  base  and  is  either  an  EVENT  or 
PhOCESS,  it  is  retrieved  and  stored  in  a stack  which  will  be 
later  used  to  produce  the  output.  The  name  is  then  used  to 
generate  a tree  structure  ot  PROCESS  and  EVENT  names  by  the 
following  method: 

If  the  name  is  an  EVENT,  the  PROCESS  (es)  and  EVENT(s)  which  it 
TRIGGERS,  TERMINATES  or  INTERRUPTS  and  the  EVENTS  which  it 
CAUSES  are  retrieved  from  the  data  base  and  placed  in  the  stack. 
Then,  the  first  name  is  removed  from  the  stack  and  placed  in  its 
proper  location  in  the  tree  data  structure.  If  this  first  name 
is  a PROCESS,  the  EVENT (s)  occurrinq  ON-INCEPTION  or 
ON-TERMINATION  of  the  PROCESS  and  the  PFOCESS(es)  which  the 
given  PROCESS  TRIGGERS,  TERMINATES  or  INTERRUPTS  are  retrieved 
and  placed  in  the  stack.  If  the  first  name  is  an  EVENT,  the 
actions  taken  are  analogous  to  the  ones  described  previously. 
This  procedure  continues,  with  names  being  removed  from  the  top 
of  the  stack,  placed  in  the  tree  structure,  and  used  to  obtain 
further  names  which  are  placed  in  the  stack.  At  any  stage  of 
this  procedure,  no  names  will  be  put  on  the  stack  if  one  of  the 
following  is  f rue: 

1)  a)  The  current  name  is  an  EVENT  which  TRIGGERS,  TERMINATES 
or  INTERRUPTS  no  PPOCISS(es)  or  CAUSES  no  EVENT (s)  . 

b)  The  current  name  is  a PROCESS  which  has  no  EVENT  (s) 
occurring  ON-INCFPTIuN  or  on-T*TM JNATION  or  which  TRIGGERS, 
TERMINATES  or  INTERRUPTS  no  PFOCESS (es) . 

2)  The  current  name  has  been  encountered  earlier,  and  is 
therefore  at  the  end  of  a chain  or  forms  a loop  with  some 
portion  of  a chain  traced  earlier. 

3)  The  number  of  links  that  has  been  traced  on  the  current 
chain  is  equal  to  the  limit  set  by  the  LINKS  parameter. 
Every  input  name  for  which  this  occurs,  is  followed  by  the 
message: 


"USER  LINK  LIMIT  OF  no.  of  links  REACHED" 

Thus,  in  any  of  these  cases,  the  size  of  the  stack  will 
decrease.  the  entire  procedure  is  complete  when,  after  any 
search,  the  stack  is  empty. 


If  the  name  input  is  a PROCESS  name,  the  first  search  is  for 
EVENT (s)  occurring  ON-INCEPTION  or  ON-TERMINATION  of  that 
PROCESS  and  for  PROCESS (us)  which  the  given  PFOCESS  TRIGGFR  S , 
TERMINATES  or  INTFFFUPTS.  From  there,  the  procedure  is 
identical  to  that  described  above. 

The  data  structure  constructed  from  all  names  found  as  above  is 
broken  into  page-size  units  and  is  printed  a page  at  a time. 


Part  ill  UFA  outputs 


UFA  User’s  Manual 


338 


The  process  described  above  is  repeated  until  no  sore  names  are 
specified  by  the  user  or  remain  in  the  input  file. 


L 


Usaje 

The  PR0C2SS  CilAIS  report  presorts  a comprehensive  view  of  the 
dynamic  behavior  of  the  processes  within  the  target  system  for 
inclusion  in  the  final  specifications  of  the  system  or  as  an  aid 
in  communicating  this  inforaation  to  others. 


Problea  Defirers  may  use  the  PF0C2SS  CHAIN  report  to  visually 
analyze  the  description  ot  particular  objects  and  the  system  as 
a whole,  for  completeness.  Table  *5  presents  completeness  checks 
that  can  be  made  by  visually  scanninq  PROCESS  CHAIN  reports. 

Programmers  and  System  Designers  in  particular  will  find  this 
report  helpful  in  identifying  and  optimizing  the  systea  loqir. 

If  the  processes  are  defined  to  the  level  of  computable 
statements,  the  PhOCISS  CHAIN  report  will  essentially  chart  out 
the  program  logic. 


i 
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JilAABle 

Figure  62  presents  a PROCESS  CHAIN  for  the  EVENT 
Msalaried-emp-processing-init.  " 


PROCESS 

The  absence  of  anv  EVENT  as  a result  of 
INCEPTION  or  'rFFMINATION  of  the  PROCESS  should 
be  rationalized. 

The  absence  of  anv  PROCESS  beinq  TRIGGERED. 
INTERRUPTED  or  TrcFTNATED  by  the  PROCESS  should 
be  rationalized. 

EVENT 

The  absence  of  any  PROCESS  beinq  TRIGGERED, 
INTERRUPTED  or  TEF KINATED  by  the  EVENT  should 
be  rationalized. 

The  absence  of  any  EVENT  beinq  CAUSED  By  the 
EVFNT  should  be  rationalized. 

System 

Description 

All  chains  should  terminate  in  one  of  three 
ways: 

1)  In  a loop  back  into  the  chair. 

2)  By  a PROCESS  designating  the  last  activity 
in  the  procedure  represented  by  the  chain 

3)  By  an  EVENT  designating  termination  of  a 
procedure  represented  by  a chain 

Given  a particular  PROCESS  or  EVENT,  the  report 
.allows  a trace  to  be  made  through  the  system  of 
actions  taken.  Checks  can  be  made  that  based 
on  a particular  starting  point  all 
} EVENT- PROCESS  chains  ovolvinq  from  the  startinq 
point  terminate  correctly. 

Table  9 


Completeness  Checks  that  may 
Visual  Analysis  of  the  PROCESS 


be  made  by 
CHAIN  Peport 
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££S£f.£S  I SPUTA?  u:  PUT 


Purpose 

To  present  in  *n  easy  to  examine  outline  form,  the  basic 
functions  of  one  or  more  PROCESSES  in  the  Language  description 
and  how  these  PROCESSES  interact  with  information. 


Information  Presented 

The  report  presents,  for  the  FROCFSE  names  qiven  as  input.,  four 
types  of  information  which  may  be  printed  or  suppressed  by  the 
specification  of  appropriate  parameters  for  the  command 
generating  the  report. 

The  DESCRIPTION  parameter  permits  the  printing  of  the 
DESCRIPTION  comment  entry  for  each  PFOCESS  if  available.  The 
PROCEDURE  parameter  permits  the  printing  of  the  PROCEDURE 
comment  entry  tor  each  PROCESS  if  available. 

The  INPUT  parameter  permits  the  printing  of  the  names  of  all 
SETS,  INPUTS,  ENTITIES,  GFOUPS  and/or  ELEMENTS  that  are  FFCEIVED 
and/or  USED  by  each  PFOCESS.  The  OUTPU'7'  parameter  permits  the 
printing  of  the  names  of  all  SE^S,  OUTPUTS,  ENTITIES,  GFOUPS 
and/or  ELEMENTS  that  GENF FATED,  UPDATED  and/or  DERIVED  by  each 
PROCESS. 


lyiiat 

An  entry  in  the  report  is  printed  for  each  PROCESS  name  given  as 
input.  Each  name  is  identified  by  a number,  1*,  2*,  etc., 
designating  its  position  in  the  input  stream.  The  following 
format  is  used  to  print  out  information  about  each  piocess: 

#*  process  name 

[DESCRIPTION  comment  entry] 

[ PROCEDURE  comment  entry] 

***  INPUTS  *** 

[All  INPUTS  RECEIVED  by  the  PFOCESS] 

[All  SETS.  INPUTS,  ENTITIES,  GFOUPS  and  ELEMENTS  USED 
by  the  PFOCESS] 

***  OUTPUTS  *** 

[All  OUTPUTS  GENERATED  by  the  PROCESS] 
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[All  SETS,  OUTPUTS,  ENTITIES,  GROUPS  and  ELEMENTS 
DERIVED  by  the  PFOCESS] 


[All  SETS,  ENTITIES,  OFOUPS  and  ELEMENTS  UPDATED  by 
the  PROCESS] 

All  the  names  listed  under  the  INPUTS  and  OUTPUTS  headings  are 
numbered  sequentially. 

If  a DESCRIPTION  or  PROCEDURE  comment  entry  is  not  available  for 
a particular  name,  that  part  of  the  format  is  not  included  in 
the  report.  If  no  names  are  listed  under  the  INPUTS  heading, 
the  message: 

NO  INPUTS  FOF  TUTS  PROCESS 


will  be  printed.  If  no  names  are  listed  under  the  OUTPUTS 
heading,  the  message: 


NO  OUTPUTS  FOF  THIS  PFOCESS 


will  be  printed. 

Options  and  Alter  nsli  yes 

Any  part  of  the  information  presented  for  each  PROCESS  name  can 
be  included  in  or  omitted  from  the  report  depending  on  the 


parameters  used  when 

generated  it.  The  parameters  and  their 

effect  on  the  report 

are  given  below: 

1)  DESCFI PTION  - 

specifies  that  the  DESCRIPTION  comment 
entry  for  each  name  be  included  in  the 
report . 

NODESCPIPTICN  - 

specifies  that  the  comment  entry  is  not 
printed . 

2)  PPOCFDUHE  - 

specifies  that  the  PROCEDURE  comment 
entry  for  each  name  be  included  in  the 
report . 

NOPROCEDUF.E  - 

specifies  that  the  PROCEDURE  comment 
entry  is  net  printed. 

3)  INPUT  - 

specifies  that  names  USED  or  RECEIVED  by 
the  PPOCLSS  are  presented  in  the  report. 

NOINPUT  - 

specifies  that  those  names  are  not 
printed . 

4)  OUTPUT  - 

soecifies  that  names  DERIVED,  UPDATED  or 
GENERATED  by  Nie  PFOCESS  are  presented  I: 
the  report. 
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NOOUTPUT  - specifies  that  these  names  are  not 

printed. 

Each  entry  of  the  report  is  started  at  the  beginning  of  a new 
page  when  the  NEW-PAG3  parameter  is  specified.  When  NONEW-PAGE 
is  in  effect,  the  entries  are  printed  one  after  another  in  the 
report. 

An  INDEX  for  the  report  is  produced  when  the  INDEX  parameter  is 
specified . 

« The  report  may  be  generated  for  a single  name  (via  the  NAME 

parameter)  or  for  a collection  of  names  either  specified  by  the 
user  or  retrieved  via  NAML-GEN. 

'• 

Analysis 

Each  name  given  as  input  to  the  software  producing  the  report  is 
searched  for  in  the  data  base.  If  it  is  not  found  the  message: 

UEAC76:  MAINPFIO:  NAME  NOT  IN  DATA  BASE  - 

is  printed.  If  it  is  found  a check  is  made  that  it  is  a PPOCESS 
name.  If  it  is  not,  the  message: 

rjRA.186:  MAINPFIO:  NAME  NOT  A PROCESS  NAME  - 

is  printed.  If  the  name  is  a PFOCESS  name,  then  the  information 
available  for  it,  as  requested  by  the  parameters,  is  presented 
on  the  report. 


Usage 

This  report  is  beneficial  in  presenting  a general  description  of 
the  functions  of  target  system  (as  described  by  the  PROCESS)  for 
purposes  of  communications  between  analysts  and  users. 

It  may  also  be  used  by  analysts  to  check  that  the  DESCRIPTION 
and  PROCEDURE  defined  for  each  PROCESS  is  in  agreement  with  the 
information  which  is  input  to  or  output  from  the  PROCESS. 


I 

* 

P 
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Figure  63  presents  a PFOCFSS  INPUT/0UTPU1  report  for  a single 
naae  "payroll-processing.*'  This  was  done  by  the  following 
co* a and: 


PROCJ SS-INPU7-0UTPUT  NAME*  payroll- processing 

Fiqure  64  presents  the  report  generated  for  the  SUBPARTS  of 
"payroll- processing . " This  was  done  by  the  following  coaaands: 

NAME-GEN  S* * SUBPART5-0F*payroll- processing, 1 ' 

PROCESS-INPUT-OUTPUT  PFOCFBUPb 
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PFOJECTED  COST  RFPOKT 


Purpose 

This  report  is  intended  to  calculate  the  projected  cost  of  a 
system  or  subsystem  using  the  user  provided  projected  cost 
equation  which  contains  system- pa ramete rs  and  attribute  names  in 
the  URA  data  base. 


Information  Presented 

For  each  name  received  as  input,  the  report  presents  a list  of 
all  related  SYSTEM- PARAMETERS  and  ATTRIBUTE  names  together  with 
their  associated  values  used  to  evaluate  the  projected  cost 
equation . 

The  projected  cost  equation  is  an  expression  comprised  of 
operands  and  operators.  The  operands  consist  of  attributes, 
system- pa  ra  meters,  integers  and  decim.il  constants.  The 
arithmetic  operators  consist  of  ♦,  *,  and  /(divide). 

Function  modifiers  may  be  used  in  the  expression  for  computing 
natural  logs  (LN) , base-10  loqs  (LOG),  and  natural 
exponentiation  (EXP) . 

The.  expression  is  evaluated  for  each  name  given  as  input  using 
the  values  of  the  corresponding  attributes  and 

system- pa ra meters . The  value  of  the  expression  is  the  estimated 
total  amount  of  resource  units  required. 


Format 

First,  the  computer  searches  the  data  base  for  all  ATTFIBUTE 
names  and  3 YSTEK- PARAMETER  used  in  the  equation  and  retrieves 
the  values  associated  with  them.  If  the  names  are  not  of  the 
ATTRIBUTE  or  S YSTEM-PAFAMETER.  type  then  an  invalid  operand  error 
message  is  given. 

A list  containing  these  attribute  names  and  s ysten- parameters  is 
printed  under  the  "Componen  t " column  heading  in  the  report  with 
the  corresponding  value  under  the  "Amount"  column  heading. 
Following  the  list,  the  total  uni*s  of  resource  caluculated  from 
the  equation  is  presented  under  the  "Amount"  column  as: 

total  units  OF  resource  RLQUItrc 

where  the  "total"  is  replaced  bv  the  calculated  amount,  and  the 
"units"  and  "resource"  are  replaced  by  the  values  of  the  UNITS 
and  RESOUFCc  parameters. 
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Options  and  Alter nat  i v as 


If  some  system  parameter 
have  a numerical  value, 
DEFAULT  parameter  is  use 


occurs  in  the  expression  but  does  not 
the  default  value  specified  by  the 
d as  the  value  for  that  system 


parameter . 

An  index,  containing  each  name  used  on  the  report  and  the 
page(s)  on  which  they  appear,  may  be  obtained  by  specifying  the 


INDEX  parameter. 


Analysis 

Each  name  given  as  input  is  first  checked  to  see  if  it  is  in  the 
data  base.  If  it  is  not  the  messaqe 

U F A 5 C 0 : M A I N PCR : NAKS  NOT  IN  DATA  3ASE- 

is  prin^rd  and  the  next  name  is  similarly  considered. 

If  the  name  is  in  the  data  base,  the  program  starts  evaluating 
the  arithmetic  expression. 

The  evaluation  of  the  expression  heqins  by  isolating  each 
component  of  the  expression  starting  from  the  leftmost 
component. 

If  the  isolated  component  is  either  an  operator  or  a numerical 
operand,  the  parsing  starts  using  a push-down  stack  and  "Polish'* 
form.  The  parsed  expression  is  stored  in  permanent  stack  and  is 
used  to  evaluate  the  expression  for  all  input  names. 

It  the  isolated  component  is  a system  parameter,  the  value  of 
the  system  parameter  is  retrieved  from  the  data  base  and  stored 
in  the  stack.  If  the  isolated  component  is  an  attribute- name, 
its  data  base  key  is  retrieved  and  stored  in  the  stack.  The 
numeric  value  of  an  attribute  for  a given  name  is  retrieved  from 
data  base  during  the  evaluation  of  expression  for  that  given 
name. 

If  the  component  is  neither  a system-parameter  nor 
attribute-name  associated  with  the  given  input  name,  the 
messaqe: 

UP  AU95 : PCF : NON- NUMERIC  OPFFANE  - 

will  be  printed.  # | 

If  the  name  does  not  have  attribute  specified  in  the  expression, 
the  messaqe: 

UFA496:PCR:  NAM  DOES  NOT  HAVE  ATTRIBUTE  - 
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will  be  printed. 

If  the  component  is  an  attr i hute-nam^  but  does  not  have 
numerical  value,  the  message: 


URA497 : PC^ : ATTRIBUTE  POES  NOT  HAVE  NUMFPIC  VALUE:  - 
will  be  printed. 

If  the  component  is  a .system-parameter  but  does  not  have 
numerical  value,  the  default  value  will  be  assiqned  to  the 
component . 


When  a system  parameter  or  an  attribute  has  a range  of  numeric 
values,  the  value  of  the  lower  bound  is  used  in  computation. 


If  any  error  condition  occurs  during  the  parsinq  of  the 
arithmetic  expression,  the  messaqe: 


UFA  493:PCR:  ILLEGAL  ARITHMETIC  EXPRESSION  - 

will  be  printed,  and  tne  processing  will  bo  terminated  for  i-he 
qiven  input  name. 

Ourinq  the  evaluation  of  the  expression  for  an  input  name,  if 
the  value  assiqned  tor  LN  or  LOO  is  found  tc  be  neqative  or  if 
the  denominator  is  found  to  be  zero,  the  error  messaqes: 


UR  A4  98 : PCR : NEGATIVE  VALUE  FOF  LN  CR  ICG  - 
UPA409:PCR:  ZERO  DENOMINATOR  - 


will  be  printed  respectively  and  the  evaluation  will  be 
terminated  for  the  qiven  input  name. 

Since  the  user-defined  names  may  contain  the  operator  characters 
as  part  of  their  name  *he  operators  in  the  expression  must 
always  be  delimited  by  blanks.  If  any  operator  is  not  delimited 
by  blanks,  it  will  bo  considered  as  part  of  the  non-numeric 
operand  and  will  result  in  an  error  condition. 

Braces  ({})  should  be  employed  to  indicate  the  precedence  within 
the  expression  instead  of  usinq  parentheses,  because  the 
parentheses  are  valid  characters  in  user-defined  names. 


.Usage 

It  is  common  practice  for  the  system  designer  to  attempt  to 
evaluate  the  total  resource  required  under  certain  design 
specifications  of  the  system.  Furthermore,  if  there  aie  several 
design  alternatives  one  of  the  selection  criteria  might  be  the 
costs  estimated  for  the  various  a 1 1 ernat i ves. 

The  analyst,  can  use  this  report  *o  calculate  a cost  toi  a system 
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or  to  evaluate  design  alternatives  in  terms  of  total  resource 
required. 

The  analyst  may  develop  numerous  arithmetic  expressions.  It  is 
possible  to  calculate  various  costs  usinq  the  different  cost 
expressions . 


Figure  65  illustrates  the  Prolect  Cost  Report  from  the  following 
Analyzer  commands: 

PCP  N*hired-employee-report  DEF=K'  RSC=»oney 

U=$  E=*copies  t many* 
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PUNCHED  COM^INT  ^.NTFJES 


Purpose 


To  present  selected  comment,  entries  given  for  one  or  more  names 
in  a particular  data  base. 


^formation  Presented 

The  report  presents,  for  those  names  given  as  input,  any  comment 
entries  which  are  specified  as  parameters  and  are  available  for 
the  names.  The  types  of  comment  entries  available  for  each  name 
are  dependent  on  the  name  type  of  the  name  the  report  is  being 
generated  for.  The  table  below  shows  the  types  of  comment 
entries  that  may  be  presented  and  the  types  of  names  they  may  be 
presented  tor. 


Comment  Entry  Type 


Name  Type 


DESCRIPTION 
PROCEDURE 
VOLATILITY 
VOLATI  LITY-tiEdBEP 
VOLATILITY-SET 
DERIVATION 
TFHE-WHILE 
FALSE-  WHILE 


All  name  types 
PROCESS 
ENTITY 
SET 
SET 

PEIATION  and 
CONDITION 
CONDITION 


Format 


An  entry  in  the  report  is  printed  for  each  comment  entry 
presented  for  each  name  qiven  as  input.  Each  entry  is  numbered 
1*,  2*,  etc.  The  format  of  each  entry  is: 

name 

comment- entry-statement; 

[comment  entry  texf]; 

Each  line  of  the  comment  entry  text  is  numbered  within  a given 
report  entry. 


jjPt.iSPS  Alter  flatjv-js 

An  entry  in  the  report  is  produced  for  each  comment  entry  (as 
specified  by  the  parameters  for  the  command  generated  the 
report)  available  tor  each  name  qiven  as  input.  The  following 
parameters  designate  the  comment  entries  to  be  presented: 
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DERIVATION  DESCRIPTION  FALSE-WHILE 

PROCEDURE  TRUE- WHILE  VOLATILITY 


VOLATILITY-MEMBER  VOLATI I IT Y- SET 


Any  of  these  parameters  prefixed  with  "NO"  specifies  that  the 
corresponding  comment  entries  are  not  to  be  presented  in  the 
report. 


An  alvsis 

Each  name  given  as  input  to  the  software  generating  the  report 
is  searched  for  in  the  data  hase.  If  it  is  not  found  the 
message: 


UPA135:  MAIN  PC OH : NAME  NOT  FOUND  IN  DATA  BASE  - 

is  printed.  If  the  name  is  found  then  those  comment  entries  (as 
specified  by  the  parameters)  which  are  available  for  it  are 
printed  on  the  report. 


Usage 

The  report  may  be  used  by  analysts  to  check  the  availability  of 
specific  types  of  comment  entries  for  a class  of  names.  For 
example,  to  check  that  all  SETS  have  VOLATILITY-MEMBER, 
VOLATILITY- SET , and  DERIVATION  comment  entries  the  commands: 

NAME-GEN  S='SET' 

PUNCH- COMMENT- ENTRY  VOLATILITY- MEM BFF  VOLATILITY-SET 
DERIVATION 


can  be  given. 


Examples 

Figure  66  presents  the  report  for  the  name 

"salaried-employee-processing."  The  command  used  to  produce 
this  example  was: 

PUNCH- COMMENT-ENTRY  NAME=salar ied- employee- processing 
PROCEDURE 
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FFSOUSCi  CONSUMPTION  Ff PORT 


To  estimate  the  amount.  of  the  resources  that  are  consumed  by  the 
processors  in  performing  a given  root  process. 


Information  Presented 

The  RESOURCE  CONSUMPTION  Report  can  present  two  kinds  of 
in  formation : 

a)  For  each  processor  which  is  used  to  perform  the  given  root 
process  the  following  appears: 

1)  The  name  of  the  processor. 

2)  The  frequency  of  processor  use  in  terms  of  a user 
supplied  interval. 

3)  A list  of  names  of  the  resources  that  the  processor 
consumes  together  wi*h  the  amount  consumed  and  the  unit  in 
which  the  resource  is  measured. 

b)  For  each  resource  consumed  when  the  root  process  is 
performed  the  following  appears: 

1)  A list  of  names  of  the  processors  which  consume  the 
resource  together  with  the  frequency  of  usaqe  in  terms  of 
the  specified  interval  and  the  amount  of  the  resource 
consumed. 


Format 

The  format  for  the  PROCESSOR  and  FE50URCE  information  is  as 
shown  in  the  following  example: 


PROCESSOR  PETER 


RESOURCE  CONSUMED 


PI 

F2 

R3 


IS  INVOKED 


AMOUNT  CONSUMED 


14576  R 
10512 
16  44 


64  TIKES  PEF  YEAR 

MEASURED  IN 

DOLLARS 

TONS 

MICROSECONDS 


RESOURCE  El 


MEASUPFP  IN  DOLLARS 
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PROCESSOR  CONSUMING  FREQUENCY  AMOUNT  CONSUMED 


PETEF 

64 

145768 

SAM 

52 

592800 

FRED 

12 

612 

TOTALS 

128 

739180 

Options  and  Alternatives 

If  one  is  only  interested  in  a certain  type  of  processor,  the 
PROCESSOR-KE YWOFD  parameter  may  be  specified.  In  this  case,  the 
processor  part  of  the  report  will  be  broken  into  two  sections. 
The  first  section  will  show  those  processors  which  have  the 
specified  keyword,  and  the  second  section  will  list  all  the 
other  processor  under  the  heading  "OTHER  PFOCESSOFS." 

The  resource  part  of  the  report  will  also  bt  altered  if  the 
PPOCESSOF-KE YWOFD  parameter  is  specified.  For  each  resource, 
the  processors  which  have  the  specified  keyword  are  first  listed 
and  the  other  processors  that  consume  the  resource  are  listed 
under  "OTHEF  PFOCESSOFS." 

The  PROCESS- LEVEL^num be r parameter  does  not  change  the  format  of 
the  output,  but  it  is  used  to  control  the  "level  of  detail"  ot 
the  analysis.  Only  as  many  levels  as  specified  in  this 
parameter  will  be  probed  in  the  process  structure  beginning  at 
the  root-process. 


r 

» 


f 


i 


When  the  output  is  expected  to  be  fairly  large  (i.e.,  contains 
many  user-names  in  it) , it  is  advantaueous  to  specify  the  INDEX 
parameter  to  generate  an  index  report  that  shows  all  the 
user-names  that  appear  in  the  report  and  the  report  page 
number  (s)  on  which  they  appear. 


Analysis 

The  program  searches  the  data  base  for  each  process  name  given 
as  input.  If  the  name  is  not  found,  the  message: 

UF  AC 59 : PPEPFO:  ROOT  PROCESS  NOT  FOUND  IN  DATA  BASE  - 

is  printed  and  no  information  is  presented  for  that  process 
name. 

If  the  process  is  found  in  the  data  base,  the  program  then 
performs  a walk  of  the  subparts- ut  ilizes  network  which  starts  at 
the  specified  process  name  and  extends  downward  to  the  specified 
number  of  levels.  For  each  visit  to  each  process  in  the 
structure,  the  resource  consumption  and  processor  frequency 
information  is  computed  and  recorded.  After  the  network  has 
been  traversed,  the  recorded  information  is  printed. 


I 
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It  is  important  to  realize  that  a process  may  be  visited  more 
than  once,  and  that  its  resource  consumption  is  computed  each 
time  it  is  visited.  This  corresponds  to  the  fact  that  a 
component  process  may  be  performed  many  times  as  a root  process 
is  performed  once. 

Por  the  network  shown  below,  where  continuous  lines  represent  a 
subpart  relation  and  broken  lines  represent  a utilizes  relation, 
processes  Pi,  P2,  P3,  P4,  P5,  P6 , PS  and  P9  are  each  counted 
once.  Processes  P7,  P11,  Pi  2 and  Pi  3 are  each  counted  three 
times.  Process  P10  is  counted  twice.  And  process  P14,  P13  and 
P16  are  each  counted  eight  times. 


Pi  3 P 1 6 


Thus,  a very  simple  structure  can  generate  a large  number  of 
computations. 


The  program  expects  to  find  the  following  information  in  the 
data  base: 

- Each  process  must  have  a frequency  value.  The  freguency  value 
must  be  convertable  t.o  "times  per  given  INTERVAL.'*  The  program 
will  only  make  one  level  interval  conversions.  For  example,  if 
the  following  information  is  in  the  data  base: 

YEAR  CONSISTS  OF  52  WEEKS; 

WEEKS  CONSISTS  OF  7 DAYS; 

Then  the  program  will  convert  weeks  to  years  or  years  to  weeks 
but.  will  not  convert  years  to  days  or  days  to  years.  For  this, 
the  statement: 

YEAR  CONSISTS  OF  365  DAYS; 
must  be  given. 
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- Each  process  must  be  performed  by  exactly  one  processor* 

If  the  above  conditions  are  not  set,  error  messaqes  will  be 
printed  and  the  analysis  will  be  incomplete. 


Usage 

The  report  can  be  used  to  estimate  the  usage  of  the  resources 
that  are  consumed  by  the  processors  in  performing  a given 
process.  The  estimate  is  accumulated  for  a given  interval  based 
on  the  user-specified  resource  usage  parameters  for  each 
processor  and  the  resource  usage  parameters  which  are  components 
of  the  given  process. 


Figure  67  represents  the  output  of  the  following  command: 

RCA  N=hourly-em ployee- processing  PL*50  INT*week  BP  BF 

PR=ALL 

Fiqure  68  represents  the  output  of  the  following  command: 

NG  s='SO=hourly-paycheck-production'  NOPRIMT 
RCA  F INT=veek 
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fui££se 

To  identity  security  conflicts  in  the  design  of  the  tarqet 
system. 


£££££111*4 

For  each  name  received  as  input,  the  report  prints  a messaqe  for 
each  security  conflict  associated  with  that  name  and  then,  at 
the  end  of  the  report,  prints  a matrix  which  summarizes  the 
security  conflicts  encountered  tor  all  the  names  received  as 
input . 

Optionally,  the  report  also  produces  a list  of  those  names  in 
the  data  base  for  which  security  information  is  possible  but  for 
which  such  information  dots  not  exist. 


ISIIdt 

The  format  of  the  report  is  self-explanatory. 


2£li2Hi2  and  Alternatives 

There  are  only  two  options: 

1)  Whether  or  not  to  have  an  index  produced. 

2)  Whether  or  not  to  include  a list  or  names  without  secuiity 
information . 


Analysis 

The  proqraa  searches  the  data  base  for  each  name  qiven  as  input. 
If  tne  name  is  not  found,  the  messaqe: 

UP  A 1 9 5:  M.AINSECA  : NAME  NOT  FOUND  IN  DB  - user-name 

is  printed  and  no  information  is  presented  tor  that  name.  The 
type  of  the  name  is  then  checked.  If  its  type  does  not  make 
sense  in  the  context  of  the  Security  Analysis  Feport  the 
message: 

UFA203:  KAINSECA  : INPUT  NAME  HAS  INVALID  TYPE 

is  printed  and  no  information  is  presented  for  that  name. 

If  the  name  is  a data  type  (i.o.,  SFT,  INPUT.  OUTPUT,  ENTITY , 
(1F0UP  or  ELEMENT)  the  followinq  steps  are  taken: 
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1)  For  t?vety  name  contained  in  the  qiven  naa©,  ©very 
classification  of  the  contained  naae  is  checked  to  see  that 
the  qiven  (containing)  naae  has  the  said  classification  at 
a level  greater  than  or  equal  to  the  level  ot  the  contained 
naae. 

2)  For  ©very  PROCESS,  PhOCLSSOF  or  INTERFACE  which  accesses 
the  qiven  naae,  evury  classification  of  the  qiven  naae  is 
checked  to  see  that  the  accessor  has  the  sate 
classification  at  a level  qreater  than  or  equal  to  the 
level  ot  the  given  (accessed)  naae. 

It  a classification  is  found  aissina,  or  a level  aisaatch  occurs 
in  one  of  the  above  steps,  an  appropriate  aessaqe  is  printed 
which  explains  the  security  conflict. 

It  the  qiven  name  is  a PROCESS,  PROCESSOR  or  INTERFACE,  then  the 
following  occurs  for  each  naae  in  the  suhparts  structure  of  the 
qiven  naae. 

Each  classification  ot  each  data  itea  that  the  naaa  accesses  is 
checked  to  see  that  the  accessing  name  has  the  saae 
classification  at  i level  greater  than  or  equal  to  the  level  of 
the  accessed  itea.  It  not,  an  appropriate  aessaqe  is  printed. 


ilsans 

■’’he  report  can  be  used  to  check  the  consistency  of  the  security 
provisions  of  the  target  r.ystea  and  to  identify  coaponents  of 
the  systea  for  which  no  security  provisions  exist. 


Figure  o9  represents  th*1  output  ot  the  following  command: 

SECA  N ’hour  l y- paycheck- va  1 id  at.  ion  PN9I  PEAT  NOINI'FX 


i'  1 1 T ’ 1 IP  A ''i|t  )>i|  t 


r* 

<T> 


c 

• 

• 

% 

o 

• 

c 

c 

• 

SO 

• 

•H 

i- 

o 

o 

G 

r- 

c 

X> 

o 

•H 

•H 

O 

• 

o 

IT3 

•H 

4 * 

4> 

• H 

CL 

c 

•H 

a 

4-' 

IT 

id 

4-» 

w 

o 

x> 

Ul 

• 

«d 

H 

lEt 

id 

10 

•H 

»T3 

o 

c 

R 

• 

14 

it 

R 

-4-> 

a 

o 

14 

C 

O 

o 

Ul 

«d 

Ul 

a 

•rl 

o 

O 

44 

144 

o 

X> 

a 

O 

•rl 

U> 

• 

44 

•H 

iS 

c: 

Sk4 

u 

• 

• 

ut 

^4 

• 

•d 

US 

kS 

U» 

•H 

’ * 4 

3 

• 

o 

g 

c 

o 

g 

c. 

R 

o 

H 

id 

•H 

G 

a. 

o 

o 

<4-4 

•H 

<U» 

o 

U 

•H 

e 

>. 

O 

<n 

*H 

■H 

c 

•H 

•H 

O 

4 * 

14 

4J 

U> 

• 

•*H 

• 

it. 

X> 

X' 

•H 

Ul 

4-> 

44 

<d 

4 ' 

o 

• r4 

H 

G 

4-» 

4-> 

G 

• 

• 

<n 

<n 

4» 

!3 

<r 

«3 

H 

• r-4 

44 

14 

14 

O 

( 

id 

O 

rj 

G 

W 

8 

8 

•*4 

u 

8 

H 

Ul 

Ul 

3 

r* 

3 

•H 

14 

0 

•H 

o 

o 

• 

•H 

Ul 

U| 

X^ 

U 

vl) 

U 

O 

3 

•H 

U 

o 

♦-> 

14 

4-1 

•H 

•H 

4~S 

v£> 

W 

o 

O 

•H 

W 

o 

>» 

44 

O 

4) 

a» 

id 

u 

o 

<d 

4-» 

O 

o 

1 

>4-4 

^44 

Ul 

u 

44 

4^ 

c: 

>, 

in 

tn 

fc» 

M 

<=» 

»d 

id 

• 

•iH 

tO 

H 

*3 

r: 

D 

V 

O 

c 

•cl 

■H 

U 

4J 

Ul 

If) 

G 

44 

ft 

Fi 

G 

4-1 

u. 

<d 

H 

•H 

o 

19 

c 

•H 

Ul 

•H 

o 

O 

O 

•r| 

o 

»-4 

14 

O 

<d 

O 

G 

3 

o 

k 4 

wS 

k. 

V44 

o 

>*4 

O 

o 

H 

H 

e> 

•< 

>, 

V. 

W 

O 

tn 

rv. 

U 

4 * 

w* 

G 

G 

G 

L4 

4J 

44 

► 4 

4-' 

*> 

c 

Id 

4- 

u> 

•rl 

o 

in 

in 

•H 

4-' 

•r  | 

c; 

G 

Id 

O 

u« 

>• 

•H 

•H 

o 

4= 

•H 

in 

Ul 

tn 

a- 

d 

id 

19 

•H 

•H 

•H 

ft 

4« 

Ul 

U 

C 

(0 

Ul 

3 

.d 

OJ 

JL 

x: 

>> 

<d 

14 

>, 

44 

G 

•3 

=9 

Id 

c 

Z3 

o 

U 

43 

4» 

J3 

3 

X* 

> 

o 

H 

u 

b 

o 

19 

-G 

o 

o 

cz 

a* 

o 

L. 

G 

•H 

u 

•H 

4 1 

4 

V4-, 

3 

0) 

<x> 

<0 

•H 

a> 

in 

tT' 

c: 

o 

O 

Ul 

42 

c* 

1 4 

•H 

•r4 

G 

>i 

u 

to 

10 

c 

G 

4-> 

U) 

in 

C 

•,4 

•H 

U 

19 

44 

44 

•H 

4 

a 

O 

Id 

<v 

o 

•H 

19 

4» 

4-' 

b 

•r4 

b 

3 

•r4 

to 

o 

o 

c 

•H 

Ul 

o 

JG 

in 

<d 

id 

a- 

a> 

4-> 

O 

Vl4 

U 

u 

>, 

44 

G 

3 

o 

4> 

vl) 

a. 

m 

■->3 

lU 

rH 

in 

o 

G 

19 

a 

3 

•H 

.d 

Ul 

n> 

•J) 

:» 

M 

lv 

r? 

in 

'vO 

•3 

U 

W 

10 

X* 

Ul 

9’ 

in 

c: 

id 

t) 

8 

u 

*T! 

o 

T*» 

m 

O 

G 

l‘ 

<d 

id 

IT 

a» 

O' 

(V 

•H 

x; 

o 

14 

1 

1 

G 

O 

id 

G 

o 

o 

3 

19 

.a 

.d 

*» 

ct 

1 

sz 

U 

O 

uS 

c: 

14 

; < 

c: 

O 

3 

»D 

v. 

in 

0) 

n. 

44 

o 

O 

tn 

fl. 

10 

■v 

o 

id 

Q, 

r> 

Ul 

a> 

4> 

i 

1 

•H 

•H 

id 

1 

vU 

<d 

10 

10 

4 S 

o 

Ul 

G 

i 

U> 

Ul 

o 

<d 

u> 

♦ * 

4-> 

4^ 

x: 

>: 

G 

.G 

«d 

Id 

id 

4-> 

O 

c 

o 

o 

»c 

V 

c 

id 

id 

0> 

id 

.k! 

x: 

o 

to 

TJ 

u 

O 

W 

0) 

c 

u 

Q. 

vi^ 

Ft 

F3 

<d 

0) 

*r^ 

S 

il 

»d 

1 

Q1 

1 

X» 

1 

OJ 

CL 

o 

R 

14 

14 

44 

.r: 

a, 

Id 

a 

u 

it 

r- 

>* 

1 

C 

44 

1 

1 

! 

r-4 

S 

O 

O 

id 

u 

3 

3 

li 

tiO 

»r* 

Id 

G> 

id 

9' 

Ul 

a. 

uu 

u 

O 

144 

144 

T1 

>, 

l 

1 

r 

.c 

»d 

14 

rn 

a. 

tl 

a. 

1 

o 

u 

8 

G 

fci 

p4 

k-. 

i 

d 

vX 

1 4 

H 

• G 

u 

• 

i 

o 

1 

>-> 

a. 

o 

a> 

a> 

0) 

U, 

•H 

•H 

X9 

a. 

b 

1* 

4.. 

r? 

X4 

ni 

T5 

a. 

to 

u 

0* 

Q« 

i 

i 

1 

G 

1 

1 

O 

l 

Q> 

a. 

3 

G 

rH 

p 

a* 

4* 

in 

o 

Ul 

0) 

>, 

>< 

>, 

r.» 

>, 

•r— > 

>-» 

1 

» 

• 

1 

.11 

5Zi 

> 

U 

o 

a. 

1 

14 

*— 4 

rH 

r4 

i 

r~4 

H 

1 

rH 

10 

to 

10 

vi« 

* r-4 

G 

O 

•H 

1 

a 

1 

U 

it 

U4 

>* 

14 

Ul 

U4 

14 

14 

U 

10 

* 

I 

M 

U 

CL, 

c> 

M 

Ul 

»r* 

r» 

r4 

D 

3 

rH 

3 

3 

r* 

3 

3 

•*H 

X. 

in 

!j’ 

R 

1^ 

1 

•H 

0) 

o 

o 

O 

Ul 

O 

O 

Ul 

O 

O 

0 

o 

O 

t: 

O 

it; 

•c 

vi? 

•*3 

xi 

.G 

Ul 

-C 

43 

D 

.c 

43 

3 

n 

xS 

G 

X. 

H 

1 

1 

H 

O 

O 

> 

X 

xt 

<0 

tO 

to 

J9 

to 

to 

to 

-C 

*0 

to 

J~. 

O) 

10 

1 4 

to 

l«* 

l « 

l » 

i/i 

01 

0) 

O) 

0) 

to 

m 

O) 

09 

0, 

to 

5- 

-t 

a, 

iU 

. j 

*G 

M 

a. 

r») 

10 

o 

r * 

0 

IO 

fL 

t'i 

0 

ro 

'0 

• 0 

i0 

0 

it, 

r> 

r» 

u 

U 

U 

u 

u 

U 

M 

u 

r? 

L) 

u 

>; 

t> 

;; 

>• 

>2 

ro 

o 

o 

o 

o 

o 

o 

o 

o 

ru 

o 

O 

o 

a 

o 

to 

o 

r i 

M 

• O 

it, 

a, 

il, 

II, 

Hi 

o. 

u. 

II. 

n, 

IL 

i». 

u. 

il 

III 

,4 

11. 

►4 

k-J 

o 

O 

• M 

«L 

t-U 

t? 

u, 

IL 

lL 

1 4 

(1, 

IL 

t!) 

LL 

IL 

Ml 

Ul 

Ml 

Mi 

Ml 

(D 

<\) 

V 

<D 

a> 

0) 

a) 

n» 

a> 

n> 

0> 

a> 

a> 

a» 

0' 

<D 

-C 

JC 

r: 

x: 

►C 

x. 

,c 

.e 

sz 

XS 

c 

x: 

.a 

JZ 

x: 

X 

sz 

l * 

f 4 

M 

fH 

f4 

i * 

f ♦ 

f ^ 

«-* 

r i 

1 4 

l 4 

M 

N 

i- 

1 4 

1 4 

i « 

1 • 

o 


o 


o 


o 


X 

► 

O 

a> 

*H 

•H 

Ui 

<T3 

to 

to 

4-> 

41 

*3 

u 

o 

4-* 

<T3 

X 

rr» 

H 

4J 

M 

U 

to 

n 

to 

u 

>P 

1) 

U 

to 

U 

p 

a 

u 

4-» 

H 

to 

Ui 

<u 

O 

X 

U 

4-* 

itf 

a* 

T?  X 

4-> 

V) 

*->  • 

4>  X (V 

hi 

T*  *H  HJ 


a» 

V 

> 

> 

a> 

a> 

*-4 

•-H 

*C 

<T? 

4-» 

4-> 

IT? 

<T3 

4> 

4-» 

C 

■ C 

*T» 

T» 

H 

*4 

Ul 

U 

to 

to 

to 

to 

a* 

nP 

u 

u 

u 

u 

TJ 

M 

•n 

X 

U> 

X 

u 

ta 

4‘ 

H 

d 

H 

U 

r? 

u 

c 

rs 

u 

J 

U 

•H 

u 

1 

• H 

1 

L4 

T* 

a* 

• r4 

*C  -C 

<T3 

• 

>»  JS 

x 

1 

1 

X 

4J  4-> 

4-» 

to 

(tl 

•T3 

4J 

IT? 

to 

>, 

tT*  4-1 

rO 

to 

4J 

04 

O. 

to 

IT? 

C 

T>  ^ 

<Ii 

1 

vl* 

• 

A) 

04 

■ r4 

tl’ 

1 > 

1 

u 

tu 

> 

Q 

O 

1 

4 

> 

T5  *T3 

T? 

u 

1 

H 

IT* 

F 

U 

Q. 

to 

T? 

Ui 

W4 

•0 

t; 

a> 

X 

01 

ITJ 

H 

• r4 

X 

(tl 

u 

i 

1 

a’ 

r~4 

O ♦-> 

O 

X. 

‘T? 

4* 

X 

X 

; 

1 

4-1 

1 to 

1 

4^ 

O 

>~4 

to 

*— 4 

41 

X 

L4 

to 

a>  zd 

0) 

•*4 

1 

tl 

U 

• H 

r-4 

0 

n n 

R 

14 

a* 

Ft 

L| 

Ui 

tl 

e 

•H 

H 

3 

R 

o 

O 

3 

tl 

4->  4> 

4.' 

U 

H 

X 

4> 

c 

u 

O 

vl> 

41 

> A 

0) 

*> 

1 4 

V 

X 

IH 

IU 

Cl* 

to 

lU 

vX 

0 

.^4 

H) 

to 

!? 

p> 

to 

o • 

O 

to 

to 

O 

• 

0 

to 

to 

U'* 

• 

U4 

»*4 

• H 

0) 

*». 

*c 

U4 

•rH 

a' 

a< 

*c 

^ a» 

o 

X 

u 

O 

vP 

c 

X 

0 

rn 

a* 

H 

4J 

u 

•r4 

41 

0 

•H 

Oi  *4-J 

4» 

(tl 

1» 

44 

• 

•u 

«ti 

44 

• 

^ • r4 

C 

a' 

X 

•H 

IT? 

G 

tp 

x 

*r4 

>S. 

4->  tO 

4-> 

> 

o 

*J 

to 

4J 

4J 

> 

0 

4J 

OO 

Ui 

to 

(T3 

4-» 

to 

<v 

*T? 

*-» 

0 

4 * 

to  *T3 

to 

X 

to 

.tf 

•CJ 

to 

X 

to 

«T? 

G 

a’  r-4 

• 

‘p 

M 

i» 

H 

1 

d‘ 

L4 

V 

»-4 

-I* 

to  u 

*TJ 

rn 

fJ 

to 

u 

>- 

to 

P 

1> 

to 

O 

1 

to 

4* 

to 

to 

to 

.TT 

to 

to 

■ r? 

to 

Cr 

a*  4 

T3 

a» 

M 

a* 

4’ 

LJ, 

tl 

tl 

u< 

4 

G 

u 

u 

o 

u 

G 

1 

u 

H 

O 

u 

X 

»r4 

u n> 

• 

u 

u 

cr 

Lm 

u 

u 

r*' 

4 * 

*H 

'O 

T3 

4J 

c 

«T? 

•H 

e 

IT? 

U 

*T? 

•r4 

to 

Ui 

V4 

•H 

•H 

L4 

d» 

rH 

•#4 

Ui 

»» 4 

c 

*T3 

c: 

a 

1 

to 

G 

H 

o to 

U 

o 

m 

o 

0) 

r^. 

0 

w ir> 

O 

Ul 

1 

H to 

1 

•r4 

•r4 

j) 

• r4 

n 

•r| 

’•0 

Ui 

4>  a> 

a> 

4-> 

•1» 

O 

4-> 

At 

ti 

44 

d> 

O 

4J 

a. 

O 

*T3  U 

R 

<T3 

> 

4-' 

T? 

U 

o 

a1 

> 

4 1 

i\? 

u 

t 4 

TT  U 

• H 

TJ 

P 

•*1 

u 

o 

T< 

4> 

CT 

0 

1 4 

•H  (T3 

4-> 

•H 

• r4 

(T 

X 

■ r-4 

3 

r4 

•r4 

■r 

vl' 

•—4 

H 

O 

<T3 

*—4 

H 

O 

IT? 

r-4 

(T? 

to 

«T1 

rr: 

<r» 

^ to 

■Tl 

n: 

»n 

to 

> 4J 

(0 

> 

r* 

> 

to 

> 

CT‘ 

> 

* * 

to 

• *r4 

a» 

1 

V 

1 

•»4 

a» 

; 

1* 

1 

•»  4 

a' 

-V  M 

u 

X 

• 

.X 

Ui 

u 

X 

• 

X 

t4 

u 

o a 

o 

U rvj 

Li 

u 

u 

U »'4 

tl 

O 

^4 

u 

a»  o 

.u 

a> 

o 

a» 

u 

*TJ 

a. 

O 

d) 

u 

-T* 

.c 

X 

44 

X 

a- 

4-4 

G 

a» 

u to 

o 

u 

o 

c 

u 

v) 

o 

U 

O 

c; 

U 

to 

0 

>* 

4.' 

X. 

*T3 

X 

41 

>., 

.T? 

4 

t3  <P 

fT* 

r 4 

»G 

<T? 

i» 

Vi 

-4 

G 

«T? 

a. 

a*  jg 

u 

a. 

a» 

4-' 

i1.X 

14 

a*  a> 

4.' 

O, 

X 

Li 

1 4J 

a* 

i 

> 

; 

4J 

a> 

1 

> 

f 

4 * 

C’ 

*7* 

>, 

<v 

tl 

T" 

<;» 

ti 

T 

r-4  V 

44 

H 

H 

a 

»«4 

a» 

U 

<—4 

r-4 

tl’ 

r-4 

a 

ti 

u > 

o 

14 

* ' 

ti 

> 

o 

LI 

4* 

Ui 

> 

O 

3 *1 

tl 

<v 

•? 

ITT 

<n 

IT1 

0? 

o c 

c: 

o 

a» 

o 

X 

s: 

O 

0) 

O 

X 

r: 

jl: 

•r4 

c 

4-> 

t4 

• r4 

X 

4 ’ 

Ui 

X 

•rH 

*■) 

*T5 

►^N 

*' 

■T< 

• 1 

to  o 

V 4 

'0 

o 

tl 

•O 

■J) 

O 

tl 

ui  c: 

a- 

n 

4* 

r-4 

i/i 

k* 

U> 

t» 

r— 4 

t>0 

G 

vl* 

0 

X 

A 

a» 

-j 

X 

P 

a: 

0 

X 

u to 

r* 

U 

Ui 

> 

L) 

to 

cr 

t; 

L4 

> 

u 

to 

O' 

O 4) 

•r4 

o 

U 

a» 

O 

0’ 

•r4 

0 

u 

a» 

0 

a' 

•r4 

|T»  O 

X 

a< 

0) 

»— 4 

li« 

o 

X 

*r. 

a1 

r— 4 

It. 

0 

X 

*T3 

l\4 

to 

t\* 

T* 

i\* 

to 

iU 

'T' 

•H  4* 

i to 
41  n • 
si)  R u 

^ V 

O 4->  X 

•— I M R 

.i*  r* 

f g 

P • I 
TJ  G 
M <i)  P 
* H -H 
»*4  *41  X 

X H <n 

4 tO  O 

*-4  *0  rH 
• J <T1  44 
•4  -H 

r o *•> 
x g 

*•*  ♦-■  a- 

X 'TT 

to  M 

U H I 

n n a> 


u to  o 
o a»  »h 
.-3  u ^ 

u s 
a t?  a* 
o 

h v.  n 
*j  *»  '0 
-T3  •><  <3‘ 
O U U 

'«  a y 

•— < (J  H? 

<t?  u> 

> V)  o 


ti  x in 

m 4’  *1> 

0 

1 vl  l 4 

V > o 
r *• 


• > 

tM  O t4 

Oj  G vl 


o a»  *h 

n.  o x 

tu 


to  to  =* 

*-4  10  4* 
X h1  I 
4 N* 
1>  U *» 
X r| 


Vi  o 

a -«-i  a> 
ti  4*  to 

to  F 

4 W h 

U 10  cii 
U 4>  -4 

*11  u u 
u O 
g r to 


> G o 

I »4 

O V 

UI  C t-| 

»n  4 v 

V -.1 

• \1  u 

O'  > O 

n <•* 


4‘ 

to  O tl 


<0 

3 

44  U 

3 rt 

V) 

a 

♦J 

M 

a 

O 

il  O 

u 

14 

D 

4' 

•rt 

0 

4’ 

o 

«*-» 

c 

at  m 

C rt 

a> 

•H 

> 

a. 

■ 

c 0 

■4  It) 

■ 

o> 

3 

0 44 

3 U 

it) 

•H 

x: 

41. 

<Q 

r-4 

9 

t—4  -rt 

4. 

«T3 

O 

44 

O 144 

C 

T« 

in 

O 

O 01 

U -rt 

01 

O 

4/ 

•rt 

tl 

<44  n 

in  jcj 

O 

> 

'O 

in 

u> 

w it) 

4>  W 

<H> 

rH 

1 

trt 

10 

c: 

<0 

iV 

O 

m 

rl 

C 

O 

O rH 

a 

> 

> 

U4 

it) 

U2 

4»  D 

.d  0 

H 

0 

c 

ro 

a 

» 

> a 

:% 

Q 

H 

^5 

•< 

a>  • 

a> 

M 

U 

0) 

r-* 

a*  0 

(i 

U1 

lv« 

►• 

Q4  (J 

B 

(4 

H 

O 

O' 

4/ 

rt 

<U  *rH 

rt«  4 * 

O 

»■ 

•H 

H r-< 

U 

♦ ’ C\J 

w2  .*3 

ftS 

•r4  (JJ  O 

>4-4  It) 

•rt  -r! 

U O'  O 
er  'H  rt 
•rt  -C 


•rt  lj 

0-4  o n 
•rt  0) 

v.  rt  a 

O'  W 4-4 
■rt  it)  0 


♦n 

U tf 

to 

in  o) 

■H 

• 

♦ » H 

it) 

in 

!— 4 

c 

IM 

ffl  O 

c: 

HI 

W rH 

•r^ 

0) 

0 

•*-'  V' 

•H 

5K 

O 

% 

> 

•H 

» n) 

4; 

O 

O 

•H 

It) 

♦J 

*H 

> 

44 

H 

rt 

J3 

rt) 

— ' Oi 

Ql 

VI 

•H  4) 

O 

tl 

jd 

£> 

ua 

» rt 

>.  VI 

*r4 

►v-H 

m 

O V 

44 

O 

<14 

• 

u in 

3 

> 

rH 

VI 

r) 

•rl 

H 

44  in 

to 

rt 

r-H  .c 

rt 

in 

rt  H 

D 

-< 

O O 

0) 

tn 

w 

in 

0)  H 

w 

» 

iti 

41  H 

a> 

it) 

•i4 

O 

44 

rt 

0 

!— 4 

c in 

♦J 

44 

a>  * 

rt 

u 

41 

•ri  'H 

H 

jC 

01 

0> 

♦»  .a 

M 

■n 

0) 

A 

» TO  4.1 

in 

*» 

4-4 

m 

0 

I > I < ( 

W • V' 

iv.  iv.  a.  t>i  i>i  mi 

r.-  t-  o v.  >; 


m 

O 

rt 

0 0 

rt 

in 

O 

.c 

u 0 

O l»t 

(0 

«T5 

01 

in 

in 

.O 

♦J 

414  ... 

*»«  H i-4 

* 4 

rt 

rt 

in  44 

rt 

'0 

0) 

• 

O'  » 

O l*»  *1 

HI 

H 

it) 

0 

rt) 

u 

0 

% 

J3 

xs 

jC 

u 

0 

«n 

il 

O 

a 

rt 

o>  in 

v> 

0 

it) 

JLi 

•0 

U» 

U 

u 

3 in 

d 

% 

.C 

nj 

in 

0 n 

in 

0 

• H 

n 

<V 

01 

rt  O 

V 

.v 

44 

w 

♦4  .£} 

* s#  n 

rt  14  0 3 
m ♦ ’ •!-*  u 
t*  vi  >u  | 
i a'  •.  i >• 

It)  >.  I rt  rt 

* ’ 3 O'  rt  •.  4 
it)  n.  u fl>  44 

t)  | 'Hfl  3 « 

| l>.  rt  rt  (J  r* 

•0  II  W 1 ’HO 

44  ai  »r4  a>  to  u 

(t)  t r-4  a I | 

u >.  • N.-H  in 

| H W O «t  3 

4>  U O — I 'rt  rt 
m s m u.  u iti 
■H  O M * O I* 

rt  -a  a>  <t>  w in 


:« 

a 

it. 


UK  A User's  Manual 


385 


STP  t!CTU P R 


To  present  the  implied  hierarchy  of  PFOCESSES,  INPUTS,  OUTPUTS, 
INTERFACES  or  PROCESSORS  definen  in  the  Analyzer  data  base,  from 
the  use  of  the  SU OP ARTS  statements  relating  them. 


Initiation  Resented 

The  report  presents  all  SUOPARTS  structures  for  a given  class  of 
names  (INTERFACES , INPUTS,  OtJTTUTS,  PROCESSES  or  PROCLSSOFS)  as 
specified  by  the  parameters  when  generating  the  report. 


The  structures  start  with  all  names  which  are  not  PAFT  of  any 
higher  structure.  These  names  are  designated  level  1 names. 

The  SUBPAFTS  of  level  1 names  are  presented  as  level  2 names. 
The  SUBPAF'iS  of  the  level  2 names  are  then  presented  and  so  on. 


Format 

The  report  presents  the  structures  under  three  headings:  COUNT, 
LEVEL,  and  NAME.  NAME  presents  the  name  of  the  obgect  in  the 
structure,  LEVEL  presents  the  level  number  associated  to  the 
name  corresponding  to  its  position  in  the  structure  and  COUNT 
presents  the  position  (line)  in  the  report  where  the  name  is 
printed  out.  Each  level  is  indented  (as  specified  by  the  INDENT 
parameter)  to  further  accent  the  idea  of  structure. 

A summary  section  for  the  report  provides  a count  (under  the 
COUNT  headinq)  of  the  number  of  names  presented  at  a given  level 
(as  designated  by  the  LEVEL  headinq)  . 


Options  and  Alternatives 

The  INPUT,  OUTPUT,  FPOCSSS,  INTEFFACE  and  PFOCESSOF  parameters 
for  the  command  specify  which  type  of  names  the  report  will  be 
produced  for.  One  and  only  one  of  ♦ hese  parameters  may  be 
specified  for  the  command  producing  the  report. 

The  number  of  spaces  which  each  level  of  the  structure  is 
indented  may  be  assigned  by  the  INDENT  parameter.  If  no  value 
is  given  INDENT  defaults  to  3,  but  may  take  on  any  value  from  1 
to  10. 

An  INDEX  for  the  report  is  produced  when  the  INDEX  parameter  is 
used . 
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A chock  is  made  that  at  least  one  name  (of  the  name  type 
designated  by  the  parameters)  exists  in  the  data  base  which  is 
not  PART  of  a larger  structure.  If  no  such  name  exists  the 
message : 


UFA288:  STMTS:  NO  NAMES  AT  LEVEL  ONE  • 

is  printed.  For  each  name  found,  its  SUBPAFTS  structure  is 
traced  and  presented  in  the  report. 

tf  a loop  is  encountered  in  the  structure  the  message: 

URA285:  FRRPS : THE  FOLLOWING  NAMFS  ARE  INVOLVED  IN  LOOPS  - 
is  printed  with  the  names  involved. 

Should  the  structure  consist  of  more  than  50  levels  (the  limit 
that  the  software  has  been  designed  to  handle)  the  Message: 

UFA284:  MAINSTF:  TOO  MANY  LEVELS  - CONTINUING  - 


is  printed. 


n5age 

The  report  is  an  aid  to  analysts  in  Maintaining  consistency  in 
structures  defined  for  the  tarqet  system  description. 

Especially  where  a top-down  approach  is  being  used,  the  analyst 
is  concerned  that  naves  have  been  inserted  into  the  proper  level 
of  a st-rucutre. 


lsajsilsi-2 

Figure  70  presents  a S7PUCTUPE  report  for  INPUT  names.  Fiquros 
71,  72,  73  and  7U  present  SIPUCTUM  reports  for  OUTPUT, 
INTERFACE,  PROCESS,  and  PFOCESSOF  names,  respecti vei y. 
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This  report  provides  statistical  information  with  respect  to  th.* 
usage  or  different  name  types  (e.g.,  P10CESSES,  ELEMENT?,  etc.) 
and  can  he  used  as  an  aid  in  estimating  size  of  the  Lanquaqe 
description  in  an  Analyzer  data  base. 


Information  Presented 

The  report  provides  an  entry  for  each,  different  name  type 
(PFOCESS,  ELEMENT,  etc.)  defined  in  a particular  data  ease.  For 
example,  if  onlv  PROCESSES  have  been  d«  fined,  only  a PFOCEES 
entry  will  appear  in  the  report.  For  each  name  type  the  report 
entry  presents: 

- The  number  of  names  in  the  data  base  of  that  nane  type  (COUNT) 

- The  number  of  these  names  that  have  CVNONYMS  (»W/SYN) 

- The  percentage  of  these  names  with  SYNONYMS  (PKFCKNT) 

- The  number  of  these  names  that  have  a DESCRIPTION  (»V/PESC) 

- The  percentage  of  these  names  with  a DESCRIPTION  (PETCENT) 

An  entry  is  also  provide!  consisting  or  all  of  the  above 
considering  all  name  types  <**TPTAL**)  in  the  data  base. 


Format 


The  report  presents  six  columns  of  information  as  follows: 

name-type  COUNT  «V/SYN  PERCENT  iW/DESC  PEFCFN7 

in  a table  format.  A row  of  the  table  consists  of  values  for 
each  or  the  above  columns.  A row  is  presented  for  each  name 
type  defined  in  the  data  base  and  the  name  types  are  presented 
in  alphabetical  order.  A row  is  also  printed  presenting  the 
total  for  each  column.  Since  there  an  a limited  number  of  name 
types,  the  report  always  tits  on  cne  page. 


£l£iiiiLS  aiii  2U£inaUves 

’’'here  are  no  options  available  for  this  report. 


An4lx»i£ 
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The  software  generat  ing  the  report  looks  at  every  naae  in  the 
lata  base  md  updates  tliiee  fields  according  to  its  name  type 
(COUNT)  , Whether  or  not  it  has  a DESCRIPTION  (IW/DESC)  , and 
whether  or  not  it  has  any  SYNONYMS  (»W/SYN).  After  all  naves 
have  been  looked  at,  percentages  (PERCENT)  for  these  naves  with 
DESCRIPTIONS  and  SYNONYMS  are  covputed  within  each  nave  type. 

Finally,  totals  are  produced  for  values  retrieved  tor  each  table 
heading  and  are  printed. 

If  *ho  report  is  generated  tor  an  evpty  data  base,  the  vessaqe: 

NC  NAMES  IN  D.D.- 

is  printed. 


Usage 

The  major  benefit  ot  this  report  is  *o  project  vanaqevent 
personnel  in  recording  progress  being  Bade  in  the  target  systev 
description  procedure.  Comparing  a particular  DATA  BASE  SUMMARY 
with  previous  summaries  allows  management  to  see  where  some  of 
the  work  effort  has  been  concentrated.  For  example,  if  52 
PROCESSES  are  counted  in  the  report  compared  to  1*  previously, 
it  shows  that  the  major  project  effort  has  been  centered  around 
definition  of  PROCESSES. 

General  progress  may  he  evaluated  by  looking  at  the  totals 
presentee  for  successive  reports. 


Ixam^les 

| i 9 

Figure  75  presents  the  SUMMARY  generated  from  a description  ot  a 
target  system. 

; ! 
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INDEX 


Purpose 

To  provide  a reference  into  a particular  URA  report  to  locate 
all  occurrences  of  the  use  of  a particular  user  defined  name  in 
the  report. 


Information  Presented 

The  report  presents  all  the  user  defined  names  used  in  a given 
UFA  report,  which  must  he  one  of  the: 


I 

X 

f 

I 


CONTENTS  FEPOF.T 
DICTIONARY  REPORT 
EXTENDED  PICTURE 
FORMATTED- PROBLEM” STATEMENT 
FREQUENCY  PEPORT 
INTERVAL  CONSISTENCY  REPORT 
PICTURE 
PROCESS  CHAIN 
PFOCESS  INPUT/dUTPUT 
PROJECTED  COST  REPORT  or 

STRUCTURE,  I 

) 

i 

the  page  numbers  in  the  report  where  each  name  occurs,  and  the 
number  of  times  the  name  appears  within  the  pages  it  occurs  (if 
more  than  once) . 


Fgr mat 

The  report  consists  of  an  entry  for  each  name  used  in  one  of  the 
above  reports.  The  entry  consists  of: 


-the  name  presented  in  the  report. 

-t.he  page  numbers  (separated  by  commas)  that  the  name  occurs  on 
in  the  report. 


-the  number  or  occurrences  (enclosed  in  brackets)  of  the  name  on 
a particular  page. 


Each  entry  is  numbered  and  the  entries  are  arranged  in 
alphabetical  order  by  name. 


Outiops  and 


t 


There  are  no  options  for  this  report. 
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AfiAlXSiS 

The  input  tor  tho  software  producing  the  INDEX  is?  obtained  from 
one  of  the  report-producing  modules  which  allows  the  INDEX 
parameter.  If  no  input  is  available,  because  the  report 
presents  no  information,  the  message; 

UEA2B7:  MAIMrX:  NO  NAi-.ES  IN  INDEX 

is  printed  if  input  is  available  (in  the  form  of  names  and  line 
numbers)  the  names  are  sortod  and  presented  as  the  INDEX  report,. 


Tho  INDEX  is  intended  as  a reference  into  a report  for  purposes 
of  locating  all  occurrences  of  »he  use  of  a particular  name  in 
the  report.  The  INDEX  is  usually  desirable  whenever  a report 
over  a few  pages  in  si?.e  is  to  be  generated. 


JS*ai.El£S 

Fiquro  7h  presents  a PTOCEsS  I N PU7/0  LIT  PUT  FEPOFT  with  an  INDEX. 
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The  UFA  Command  Lanqua-ie  consists  of  three  basic  types  of 
commands: 

i 1 

Feport  Commands 
Modifier  Commands 
Control  Commands 

Report.  Commands  retrieve  data  from  the  UFA  data  base  and  output 
it  in  some  meaninqful  format.  'rhese  reports  do  not  chanqe  the 
contents  of  the  data  base  whatsoever.  Their  purpose  is  solely 
that  of  displayinq  ordorinqs  and/oi  relationships  within  the 
current  problem  statement.  The  followinq  Feport  Commands  are 
available  in  this  version  of  the  Analyzer: 


CONSISTS- COM  PA FI  SON 

CONSISTS- MAT FIX 

CONTENTS 

DATA-PFOCESS 

DICTIONARY 

DYNAMIC-ANALYSIS 

ENTITY- IDENTIFIER 

EXTENDED- PICTUFF 

FORM  ATT ED- PF OB LEM- STATEMENT 

FFEQUENCY 

INTERVAL- CONSISTENCY 
KWIC 

LIST-CHANGES 

NAME-GEN 

NAME-LIST 

PICTUPF 

PRINT- ATTRIBUTE- VALUES 

PROCESS-CHAIN 

PROCESS- IN  PUT-OUTPUT 

PFOJECTED-COST-FFPOFT 

PtlNCH-COMMENT-ENTRY 

RESOURCE- CON  SUMPTION- ANALYSIS 

SECURITY- ANALYSIS 

STRUCTURE 

SUMMARY 

Modifier  Commands  are  intended  to  modify  the  contents  of  the  UFA 
data  base  in  the  manner  defined  bv  the  problem  definer.  These 
commands  take  leqal  URL  statements  or  URL  names  as  input.  UFA 
then  generates  error  diagnostics  as  well  as  an  output  report  to 
present  the  outcome  of  the  data  base  alteration.  The  follovina 
Modifier  Commands  are  available  in  this  version  of  the  Analyzer: 
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CHANGF-TYPF 

DELLTF! 

DELETE-COMMFNT-ENTFY 
DELETE- PSL 
INPUT- PSL 
RENAME 

REPLACE- COM  MEN T-ENTFY 

Control  commands  are  the  means  to  pass  certain  control 
information  to  the  User  Requirements  Analyzer.  The  SET  command, 
for  example,  allows  the  user  to  define  which  UFA  data  base  is  to 
be  accessed  by  the  Peport  and  Modifier  Commands  as  well  as 
settinq  various  switches  and  assigning  input  and  output  files. 
Control  Commands  are  installation  dependent  and  therefore  are 
qiven  in  Appendix  E, 

Alt houq h any  of  the  commands  can  be  issued  independently  of  each 
other,  it  is  often  advantaqeous  to  use  some  commands  in 
sequence.  This  means  that  output  of  one  command  can  be  used  as 
input  by  another.  The  most  common  instance  of  this  is  when 
NAME-GEN  is  used  to  select  certain  names  (say  all  PROCESSES  for 
example)  which  can  then  be  used  as  input  to  a Beport  Command 
(possibly  PICTURE , for  a PICTURE  FFPOKT  for  all  PROCESS  names) . 


Ilil  lifi  £0M£AND  ],  ANGUA^E^INSTAii.A  TION  DEPENDENCIES 


UFA  is  a software  system  that  is  desiqned  to  be  used 
interacti vely  in  a time  sharing  system  environment.  It  contains 
its  own  data  base  management  system  but  it  is  dependent  on  the 
time  sharing  operating  system  tor  the  usual  facilities  of  sign 
on,  identification  and  secuiity,  file  creation  and  editing,  etc. 

Differences  in  operating  systems  and  operations  at  particular 
installations  affect  the  way  in  which  UFA  is  executed  at  a 
particular  installation.  There  are  basically  three  aspects  of 
UPA  that  are  installation  "dependent”: 

1)  Control  commands 

2)  Method  of  initiating  and  executing  UFA 

3)  File  names  used  by  UFA 

These  dependencies  are  presented  in  Appendix  E. 

UFA  can  also  be  used  in  batch  mode  at  most  installations.  The 
commands  necessary  to  accomplish  this  are  also  installation 
dependent  and  are  not  covered  in  this  manual. 
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ABBF  SVIATIONS 


To  enable  the  "ser  to 
and  eliminate  some  of 
abbreviated  forms  for 
Each  abbreviation  can 
following  the  word  it 


fit  a lengthy  command  on  the  alotted  line 
the  tedium  of  command  specification, 
both  commands  and  parameters  may  be  used, 
be  found  in  parentheses  immediately 
represents.  For  example,  the  command: 


CHANGE- "YPF  NAKF=GRCSb-PAY  T Y PF  = EL  LM  E NT  can  be  written  as 


CT 


N=GROSS*  PAY  T = ELFKENT 


DLANKS 

A blank  bus*  appear  between  the  command  and  any  accompanying 
parameter,  and  between  successive  parameters.  Several  blanks 
are  treated  as  a single  blank  and  may  be  inserted  whenever  a 
single  blank  is  necessary.  For  example: 

CT  N *i? ROSS** PA Y T=ELEMINT  can  be  written  as 

CT  NxGROSS-  PAY  'r  = EIEKFNT 


PEACES 

In  the  following  examples,  when  parameters  or  parameter  values 
are  enclosed  in  braces  ((  }),  a choice  among  the  two  or  more 
entries  must,  bo  made.  It  is  important  to  note  that  one  and  only 
one  of  the  options  must  be  chosen.  For  example,  the  braces  used 
in  describing  the  syntax  of  the  CHANGE- TYPF  command  specifies 
that  the  command  must  either  be  of  the  form: 

CT  N=user-nam«  T=name-type 


or 


CT  F*fdname  f T = na me- 1 y pe  ] 


BRACKETS 

Whenever  parameter  notation  in  an  example  appears  within 
brackets  ([  ])  , it  indicates  a feature  the  user  may  optionally 

use.  For  example,  the  TYPE  parameter  in  the  CHANGE-TYPE  command 
is  optional  when  the  FILE  parameter  is  also  used.  Therefore, 
the  command  may  be  of  the  form: 

CT  FIL£*tdnam«  TYP*,*namo-t  yr«' 
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or 

CT  EILE*tdname 

The  syntax  of  the  FILE  parameter  shows  that  the  parameter  may  be 
given  either  as: 

FILE=f dname 

or  -just 

FILE 

No  other  variations  are  acceptable  (except  those  already 
specified,  i.e.,  abbreviations,  etc.). 


COMMAND  LINE 

Each  commind  must  appear  or,  a separate  line.  Only  columns  1 
through  80  of  each  line  can  be  used.  A command  line  can  be 
continued  on  the  succeeding  line  by  typing  a hyphen  or  a minus 
sign  at  the  end  of  the  current  line. 


r.EKEFAL  COMMAND  SYNTAX 

The  command  identifiers  (name  of  the  command)  must  precede  any 
accompanying  parameter  or  list  of  parameters. 


COMMAND  PARAMETERS 

Parameters  for  a command  separated  by  one  or  more  blanks. 
Parameters  may  be  given  in  any  order,  but  are  processed  from 
left  to  right.  If  conflictinq  parameters  are  used,  the 
right-most  parameter,  i.e.,  the  last  one  given,  is  considered  to 
be  correct  and  is  the  one  used  in  the  processing  of  the  command. 


ELLIPSIS 

The  ellipsis  (...)  signifies  that  the  command  construct 
immediately  preceding  the  ellipsis  can  be  repeated  as  many  times 
as  desired  by  the  user. 


INTEOF.FS 


The  integers  required  for  parameters  must  be  positive  integers. 
If  a value  range  is  given  tor  a particular  parameter 
description,  that  restriction  must  also  be  met. 
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NAMPS 

All  user  defined  names  (user-names)  must  he  formed  trom  the 
legal  character  set  present  ed  in  the  Appendix  I.  Note  the 
following: 

- A name  can  be  any  combination  of  thirty  or  less  code  3 or 
code  4 characters  where  the  first,  character  is  a letter  or 
other  code  3 character. 

- Blanks  cannot  he  used  in  the  name. 

- A user  d<  fined  name  cannot  he  a UPL  FESKFVFD  WOFPS.  For  a 
list  of  Feserved  words  see  Appendix  B of  Part  II,  PPL 
User's  Naual. 

For  example, 

d FOSS-PAY  , F.MPLOYPF-  NUMRT  ? , #-of-UNITS  a)  $. Ob/lbs. 
are  all  lecjal  names. 

PFOCESS,  12  J-HILL-STPEF.T,  WHY?,  and  PL  ANK 

are  illegal  names.  "PR0CF7SS"  cannot  he  used  as  a user-name 
because  it  is  a URL  Feserved  Word.  "1 2 V- HI IL-STFth r " is  illegal 
because  it  starts  with  in  integer  rather  than  a letter.  "WHY" 
is  illegal  because  it  contains  the  "?"  character  which  is  not 
allowed,  and  "PL  ANK"  contains  ar  imbedded  blank. 


CAPITALIZATION 

In  this  workir.n  paper  all  UFA  commands,  parameters  and  reserved 
words  appear  in  upper  case.  In  some  systems,  such  as  Multics, 
where  the  standard  command  convention  is  lower  case,  the  user 
should  use  lower  case  for  all  UFA  commands,  parameters,  and 
reserved  words. 
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lillhAl  OF  COMMAND  DlfCSIIilONf 


All  the  UFA  connun  Is  in  this  paper  are  described  in  the 

following  tonat: 

Command:  COMMA UD- NAFF  Type:  command  type 

Purpose:  This  presents  the  function  of  the  command  in  the  UFA 

system  whether  it  generates  a report,  modifies  the 
data  base  or  qives  control  information  to  URA.  (The 
'•UFA  Users  Manual"  and  "UFA  Feports"  present  detailed 
descriptions  of  the  reports  generated  by  each 
command . ) 

Prototype:  "his  presents  the  leqal  syntax  for  the  command.  The 
Command  Language  Syntax  Notation  specifies  what  the 
special  symbols  (such  as  braces  and  brackets) 
represent  in  interpretinq  the  syntax. 


Parameters: 

For  each  parameter  available  tor  the  command,  this 

section  provides  a brief  description  explaining  how 

the  parameter  changes  the  action  of  the  command. 

(Part  I and  Part  III  explain  how  to  use  these 

parameters  effectively.) 

"here  are  basically  five  types  of  parameters: 

Input  data  parameters  - these  parameters  specify 

the  data  to  be  used  as  input  to  the  command. 
FILF  and  NAFF  are  examples  of  Input  data 
parameters. 

Input  control  parameters  - these  parameters  specify 
how  the  input  data  is  to  be  used,  changed, 
etc,,  by  the  command.  The  TYTE  parameter  for 
the  CUANC.E-^YPE  command  and  CONTAINED/CONSISTS 
parameter  tor  the  CONSISTS-MATFIX  command  are 
examples  of  this  type. 

Output  data  parameters  - these  parameters  specify  it 
output  is  to  be  generated  from  the  command  and 
the  form  in  which  it  is  presented.  The  PUNCH 
an  PRINT  parameters  are  examples  of  this  type 
of  parameter. 

Output  option  parameters  - ^hese  parameters  specify 
options  which  may  be  included  or  omitted  from 
the  output.  The  LEVELS  parameter  for  the 
CONTENTS  command  and  the  DESCRIPTION  parameter 
tor  the  DICTIONAFY  command  are  examples  of  this 

type. 
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Output  format  parameters  - these  parameters  specify 
alternate  formats  for  the  presenting  the 
information  in  the  output  from  the  command. 

The  N2W-PAGF  parameter  and  HKARG  parameter  for 
the  FPS  command  are  examples  of  this. 

The  parameters  for  each  command  will  he  presented  in 
the  above  order  accord  i no  to  type. 

These  present  which  parameters  will  he  used  tor  the 
coamana,  or  what  value  a parameter  will  have,  if  the 
parameter,  or  value,  is  not  explicitly  defined.  For 
example,  if 

CONTENT  S 

is  specified,  the  defaults  for  this  command  are  such 
t.hat  this  has  the  same  effect  as  specifying: 

CONTENTS  FILF  NOINFFY  I,.VFLS  = ALL  NONCFLAG 

If  a "no  default"  is  given,  this  means  that  if  not 
explicitly  defined,  the  corresponding  parameter  will 
not  be  used  for  the  command. 

These  are  the  possible  error  messages  that  may  occur 
if  the  parameters  for  the  command  are  not  specified 
correctly.  The  "UFA  Users  Manual"  explains  what  to 
do  should  these  messages  be  encountered. 

Actual  example  of  the  command  syntax  are  presented. 
(The  results  from  these  examples  are  presented  in 
Fart  I and  Part  III.) 
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Command:  CHA NGE- TYPE  Type;  modi  tier  cojinarul 

Purpose:  To  change  the  name  type  of  a user  name  defined  in  the 

user's  data  base.  A record  of  this  change  is 
generated  in  the  form  of  the  CHANGE-TYPE- PEPORT . 

Ptototype:  CHANGE-TYPE  (C  I)  (NAMT  (N)  =user-nam«  TYPE (T) =name-typci 

(FILE  (F)  [ = f dname  ] [ TYPE  (T)  = name- tyre  ]) 


Paramet  et  s : 


Input-  FILE (F)  [ =f dname  ] Default;  no  default 

d a t a 

when  the  FILE  parameter  is  used  and  no  tdname  is 
designated,  the  contents  of  the  default  file1  are 
used  as  input  to  tht  command.  This  file  is  the  default  PUNCH 
file  for  NAME-GEN.  If  an  fdname  is  indicated,  that  file  is  used 
as  the  input  tile  tor  the  command.  The  file  format  for  each 
line  of  th>*  input  file  must,  be  of  the  form: 

user-name  f name-type] 

Free  format  is  allowed  so  the  user-name  does  not  have  to  start 
in  the  first  position  in  the  lire.  The  two  names  must  be 
separated  by  one  or  more  blanks.  The  name-type  is  optional.  If 
a name-type  is  not  specified  for  each  user-  r.a  me , the  name  type 
for  each  of  these  names  will  he  chanqed  to  the  type  specified  in 
the  TYPE  parameter.  One  of  these  alternative  methods  of 
assigning  a type  must  be  used,  but  not  both.  If  both  are  used, 
all  the  names  in  the  file  will  be  assiqned  the  name  type 
specified  by  the  TYPF  parameter. 

NAME  (N)  -user- name  Default;  no  default 

The  given  user-name  is  the  name  for  which  the  change  is  to  be 
made.  When  the  name  parameter  is  used,  the  TYPF  parameter  must 
he  used  in  conjunction  with  it. 

Input- 

TYPE  (T)  ^name-type  Default:  no  default. 

cent rol 

"his  parameter  specifies  the  new  name  type  t.o  be  used 
in  the  change.  See  Appendix  F of  "The  User 
Requirements  Language,  language  Feference  Manual"* 
foi  a list  of  all  possible  name  types. 

Messiges:  If  neither  FILE  nor  NAf*F  parameter  are  given,  the 

error  message: 


1 The  name  of  the  default  tile  is  installation  dependent  and 
consequently  is  given  in  Appendix  F. 

* Part  II,  UFL  User's  Manual. 
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NO  NAME  GIVEN 

will  be  generated  by  UFA.  It  one  of  these  two 
parameters  are  given,  but  no  TYPE  is  specified,  Mie 
error  message: 

NO  TYPE  GIVEN  WITH  " N A M F = " OP  "FILc"  PARAMETER 
will  be  qiven. 

Examples:  CHANGE-TYPE  N ANE=gross- pay  TYPE=ELEMFNT 

CT  F T = SLEME  NT 
CT  FILE  T-GPOUP 
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Command:  CON SISTS-COM  PAB ISON  Type:  report  command 

Purpose : To  produce  the  CONSISTS-COM PAPISCN  FEPOFT. 

Prototype:  CON  SISTS-CO*  PAMSON  (CNC)  [parameter]... 

Pa  rameters : 


Tnput-  FILE (F)  ( =FPNAMt ] Default:  FILE 

Data 


When  the  FILE  parameter  is  used  and  no  fdname  is 
desiqnated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
detail  It  PUNCH  file  for  NAME-GEN.  If  an  fdname  is 
indicated,  that  tile  is  used  as  the  input  file  for 
the  command  and  the  report  is  produced  usinq  all  the 
names  in  the  file.  In  any  case,  the  names  in  the 
input  file  must  be  SET,  INPUT,  OUPUT,  ENTITY  and/or 
GROUP  names.  The  format  of  the  input  file  must  be 
one  name  per  line. 


Examples:  CNC 

CNC  FILS 


i The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  qiven  in  Appendix  F. 


I 
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Command:  CONSISTS-MATflIX  Type:  report  command 

Purpose:  To  product;  the  CONSISTS  MATRIX  FtPOFT. 

Prototype:  CON SISTS-F  AT  FIX (CM)  (CONTAINED (CN"D)  } 

(CONSISTS (CSTS)  ) [parameter]... 


Parameters: 


Input-  FILE'  (F)  [ = F D N A M E ] , NAFF  (N)  = user- name  Default:  FILE 

Data 

When  the  FILE  parameter  is  used  and  no  fdnatne  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
detault  PUNCH  file  for  NAEt-GFN.  If  an  fdname  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  command.  When  a name  is  specified  via  the  NAFt 
parameter,  the  report  is  produced  only  tor  that  name. 
The  forma*  of  the  input  file  must  he  one  name  per 
line. 


Input-  CONTAINED  (CN^D)  , CON  FI  STS  (C  STS)  Default:  no  default 

Cont  rol 

Since  no  default  exists,  one  of  the  above  must  be 
specified.  If  CONTAINED  is  oiven,  the  names  used  as 
input  must  he  ELEMENT,  GFOUP,  ENTITY,  INPUT  and/or 
OUTPUT  names.  If  the  CONSISTS  parameter  is  given  the 
names  used  as  input  must  be  SFT,  ENTITY,  INPUT, 

OUTPUT  and/or  GROUP  names. 


Messages:  If  neither  CONTAINED  nor  CONSISTS  is  specified,  the 

message: 

MUST  GIVE  EITHER  CONSISTS  CL  CONTAINED  PAFAMETF.F 
will  be  printed. 

Examples:  CM  N =employee- number  CN'D 

CM  FILE  CSTS 
CM  CSTS 


• The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  F. 
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Command:  CONTENTS  Type;  Peport  command 

Purpose:  To  produce  the  CONTENTS  PFPOHT. 

Prototype:  CONTENTS  (CON*)  (parameter]... 

Parameters: 


Input- 

Data 


Output- 

Data 


Out  put- 
Opt ion 


FI1. S (F)  f =fdna me  ],  NAME  (N)  =usor- name  Default.;  FILE 

When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  tile  for  NAME-GFN.  If  an  tdname  is 
indicated,  th\t  file  is  used  as  the  input  tile  for 
the  command  and  the  report  is  produced  for  all  the 
names  in  the  file.  When  a name  is  specified  by  the 
NAME  parameter,  the  report  is  produced  tor  that  name 
alone.  In  any  car.*-,  the  names  used  as  input  to  the 
command  must  be  SF.*T,  INPUT,  OUTPUT,  ENTITY  and/or 
USO UP  names.  The  format  ot  the  input  tile  must  be 
one  name  nor  line. 

INDEX, NOJNDEX  Default;  NOINDFX 

The  INDEX  parameter  specifies  the  production  of  an 
index  tor  the  report  consisting  ot  an  alphabetical 
listing  of  all  names  used  in  the  leport  and  the  pages 
on  which  they  occur. 

LEVELS* (integerl  Default;  LE VELS*ALL 

(ALL  | 

The  LEVELS  parameter  specifies  the  lowest  level  of 
subordinate  names  to  be  outputted.  Thu  ALL  value 
indicates  that  all  subordinate  names  should  be 
outputted.  LEVELS  can  take  on  any  integer  value  from 
1 to  SO. 

NCFI.AG,  NCNCFLAU  Default;  NONCFLAG 

The  NCFLAC  parameter  flags  all  GFOUTS  in  the  output 
repoits  that  do  not  CONSIST  of  anything  else,  and 

those  undefined  names  which  are  contained  in  a GPOUP, 
INPUT,  OUTPUT,  ENTITY  or  SET. 

PFIN !- SE’ C u MT Y- IN FOF NATION  (PS1)  , 

NO-  PUNT-  SECl'MTY-  I N FOP  N A "I  ON  ( N PS  I ) 

Default:  TSI 


1 The  name  ot  the  default,  file  is  installation  dependent  and 
consequently  is  giver,  if:  Appendix  E . 
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’’'he  PSI  parameter  leouosts  t hat  the  classification  ot 
each  entry  be  printed. 

Examples:  CONTENTS  N * v a r y i nu-o  m p lo y *»*»- d a t a 

COM " F 
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Command : 

DATA-PROCESS 

Typo : 

report  command 

Purpose : 

To  produce  the  DATA  FFOCrSS 

FEPOFT. 

Prototype: 

DATA-PR0CES3  (CP) 

(DATA  (T)  ) 

(PFOCESS  (P) ) 

[ parameter  ]. . . 

Par  ameters: 

Input- 

Data 

FILE  (F)  [ *f  dname  ],  NAME  (N) * user- name 

When  the  FILS  parameter  is  used  and 

Default:  FILE 

no  f dname  is 

Input- 
Cont  rol 


Output- 

Options 


designated,  the  contents  ot  the  default  tile*  are 
used  as  input  to  the  command.  This  is  the  default 
PUNCH  file  for  NAMF-GF.N.  if  an  tdname  is  indicated, 
that  file  is  used  as  the  input  file  for  the  command. 
The  format  of  the  input  file  must  be  one  nano  per 
line. 

When  a name  is  vjiven  via  the  NAME  parameter,  the 
report  is  produced  only  for  that  name. 


DATA  (D)  , PROCESS  (P) 


Default:  no  default 


Since  no  default  exists,  one  of  the  above  must  he 
specified.  If  DATA  is  specified,  the  names  used  as 
input  to  the  comand  must  be  SET,  INPUT,  OUTPUT, 
ENTITY,  GROUP  and/or  ELFMENT  names.  It  PFOCESS  is 
specified,  the  names  used  as  input  to  the  command 
must  he  PFOCESS  names. 


DPMAT,  NODPMAT 


Default:  DPMAT 


with  the  DPMAT  parameter  in  effect,  the  DA^A  PROCESS 
INTERACTION  MATRIX  is  presented  as  part  of  the 
report.  when  NODPMAT  is  specified,  this  matrix  is 
not  printed. 


1 


DPANL,  NODPANL 


Default:  DPANL 


With  the  DPANL  parameter  in  effect,  analysis  is  done 
on  the  DATA  DPuClSS  INTERACTION  MATFIX  (whether 
printed  or  not)  and  presented  as  ♦■he  DATA  PFOCESS 
INTERACTION  ANALYSIS.  When  NODPANL  is  specified, 
this  analysis  is  not  done. 


PMAT,  NODMAT 


Default:  PMAT 


1 The  name  ot  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  F. 


Jl 
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With  the  PMAT  parameter  in  effect, 
INTERACTION  MATRIX  is  presented  as 
report.  When  N OPM AT  is  specified, 
printed . 


the  PROCESS 
part  of  the 
this  matrix  is  not 


PA  ML,  NOPANL  Default:  PANL 

With  the  PANL  parameter  in  effect,  analysis  is  done 
on  the  PROCESS  INTERACTION  MATRIX  (whether  printed  or 
not)  and  presented  as  the  PROCESS  INTERACTION  MATFIX 
ANALYSIS.  When  NOPANL  is  specified,  this  analysis  is 
not  done. 


If  neither  DATA  nor  PROCESS  is  specified,  an  error 
message: 

MUST  GIVE  EITHFP  '‘DATA"  OF  ''PROCESS"  PAPAMETFF 
will  be  printed. 

DP  N=payroll-pr ocessinq  process 
DP  DATA 
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Coir  mand : 
Purpose: 

Prototype : 

Parameters 

Input 

Data 


Nessages: 


Examples: 


* The  name 
consequen  t 


Part 
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DELETE  Type:  moditier  command 

To  delete  a name  or  list  of  names  fiom  the  data  base. 
When  a name  is  deleted  all  of  its  connections  to 
other  names  in  the  data  base  are  also  deleted.  A 
permanent  record  of  the  change  is  also  generated  in 
the  foam  of  the  DFLETICN  PEPOFT. 

DELETE  <DEL) 

(F ILE ( F) f =f dname  ] } 

{N  AXE  (N)  =user-namej 


FILE  (F)  [ =fdname  ],  NAEP  (N)  =user-name 

Default:  no  default 

when  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdname  is 
indicated,  that  tile  is  used  as  the  input  file  for 
the  command  and  all  names  in  the  file  are  deleted 
from  the  data  base.  The  format  of  the  input  must  be 
one  name  per  line.  When  a name  is  specified  by  the 
N A X F.  parameter,  that  name  is  deleted  from  the  data 
base. 

If  neither  the  FILE  nor  NAME  parameter  is  specified, 
the  message: 

NC  NAME  OP  FILfc  WAS  SPECIFIED 
will  be  qiven. 

DELETE  N=f ield-check-new 
DEL  FILE 


of  the  default  tile  is  installation  dependent  and 
y is  given  in  Appendix  E. 
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Command: 


Purpose: 


PELETE-COKKENT-F  N7RY 


Typ'»:  modifier  command 


To  delete  from  the  data  base,  for  the  given  name  or 
list  of  names,  those  comment  entries  associated  with 
each  comment  entry  statement  specified  in  the  list  of 
parameters.  A permanent  record  ot  the  chanqe  is 
generated  in  the  form  of  the  PELLTFC  COMMENT  ENT  PI FS 
report . 


Prototype:  PEL  BTE-COMK ENT- ENTRY ( PCCM) 

(FILE  (F)(  = fdname  ] ) 

(MAKE  (N) =user-namej[ parameter  ]. 

Parameters: 


Inpu  t- 
Data 


Input- 

Control 


FILE  (F)  ( =f  dname  J,  N A F ( N ) -user- name 

Default:  no  default 


When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  ot  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
detault  PUNCH  tile  for  NAME-GEN.  If  an  fdname  is 
indicated,  that  file  is  used  us  the  input  file  for 
the  command.  When  a name  is  given  via  the  NAME 
parameter,  only  the  specified  comment  entries  for 
that  name  are  deleted.  Either  FILE  or  NAME  must  be 
qiven  but  not  both.  The  format  of  the  input  file 
must  be  one  name  per  line. 

When  qiven  as  parameters,  the  comment  entries  tor  the 
following  comment  entrv  statements  are  deleted. 

DERIVATION  (DKR)  , NOPEFIVATICN  (NDEF)  Default: 

VGDEFIVATION 


DESCRIPTION  (TESC)  , NODESCFI ITIOK  (NDESC) 

NODESCPI PI 


PTION 


FALSE-  WHILE  (FW)  , N0FAL3F-  WHILE  (N  FW)  NOFALSE- WHILE 

PROCEDURE  (PPCD)  , NOPPOCFbUhE  (NPFCD)  NOPROCEPUFE 

TRUE- WHILE  (TW)  , N0TF11F-  WHILE  (NTW)  NOTRUF-WHILE 

VOLATILITY (VOL)  , N0V01 ATTLIT Y (NVOL)  NOVCLATILI TY 

VOLATILITY- MEM BE?  (VOLM)  , NOVO  I ATI  LI TY- Mr  Mil F (NVOLM) 

NOVOLAT ILITY-MEMBIF 


* The  name  of  the  default  tile  is  installation  dependent  and 
consequently  is  qiven  in  Appendix  r. 
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VOLATILITY-SKT  (VOLS)  , NOVOLA TI LI TY-SFT  (NVOLS) 

NOVOLATILITY-SET 


Output-  PRINT  ( P)  r NOPRINT  (NP)  Default;  PFINT 

Data 

The  PRINT  parameter  initiates  the  production  of  a 
printed  DELETED  CCMMEN"  ENTRIES  report.  NOPRINT 
suppresses  the  printinq. 

Messages:  If  neither  the  FILF  nor  NAME  parameter  are  given,  the 

message: 

NO  NAME  OR  FILE  SPECIFIED 
is  printed. 

Examples:  DFLETK-CCMMFNT- ENTRY  N-newr info- validation  PPCD  DESC 

PCOM  FILE  DESC 
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Parameters 

Input- 

Data 


Out  put- 
Data 


Example: 
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PELFTr'-PSL  Type:  modifier  command 

To  delete  specific  UFL  statements  in  the  problem 
definer*s  data  base.  These  statements  used  as  input 
to  the  command  are  deleted.  A permanent  r>‘cor  I for 
the  change  is  generated  in  the  form  of  the  DFLHTVP 
NFL  report. 


DFLETr- PSL ( D FSL)  [ parameter  1. . . 


INPUT  (I) [ =f  Iname  ] 


Default : iNFUT-terminal 


when  INPUT  is  used  and  an  fdname  is  specified,  the 
contents  of  the  designated  fdname  are  used  as  input 
to  the  command.  This  input,  must  ht  in  the  same 
format  allowable  by  the  INPUT- PSL  command  (i.o., 
legal  Uhl  statements).  "be  only  exception  is  that  no 
comment  entry  statements  aie  allowed  in  the  input 
(PESCF I PTION  , toi  example).  ’’’he  EOF  statement 
terminates  input.  If  no  fdname  is  specified,  its 
value  defaults  to  the  terminal  so  that  the  UPL 
statements  can  be  entered  interactively. 

SOURCE  (S),  NO  SO  UPC?  (N.c)  Default:  SOUPCF 


When  the  SOURCE  parameter  is  in  effect,  an  f-.S-TS 
SOURCE  LISTING  (the  riLFIFO  UI.L  output)  of  the 
deleted  UPL  statements  is  produced.  When  the 
NOSOUBCS  parameter  is  given,  no  AS-IS  SOUFCE  LISTING 
is  produced. 

XFIF(X),  N0XR3F  (NX)  Default;  NOXFEF 

The  user  wav  desire  a cross  reference  for  the  AS-IS 
SOURCE  LISTING,  This  consists  of  a list  of  all 
user-defined  names  from  the  input  file  and  the  line 
numbers  on  which  they  occur  in  the  DELETED  URL 
report  . To  accomplish  this,  the  problem  define!' 
should  specify  XRFF,  When  NOXFF.F  is  in  effect,  no 
cross  reference  is  produced. 


DFLEIE- PSL  NS 
DPSL  X 


i 
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Command:  DICTIONARY 


Type:  report  command 


Purpose:  To  produce  the  DICTIONARY  REPORT  for  a name  or  list 

of  names  in  *-hc  user's  data  base 

Prototype:  DICTIONARY  (DIC?)  [parameter)... 

Parameters: 

Input-  FILE  (F)  f =f  duame  },  NAMF  (N)  =user-name 

Da “a  Default:  FILE 

When  the  FILE  parameter  is  used  and  no  tdname  is 
designated,  the  contents  of  the  default  file1  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAML-GFN.  If  an  tdname  is 
indicated,  that  file  is  used  as  the  input  file  for 
production  of  the  DICTIONARY  REPORT.  when  a name  is 
specified  via  the  NAME  parameter,  the  report  is 
generated  for  that  name  alone.  The  format  of  the 
input  file  must  be  one  name  per  line. 


nut  put- 
Dat  a 


INDEX,  NOINDEX 


Default:  NOINDEX 


When  given,  the  INDEX  parameter  specifies  the 
production  of  an  index  to  the  report.  This  index 
consists  of  an  alphabetical  listing  of  all  names  used 
in  the  report  and  the  page(s)  on  which  they  occur  in 
the  report. 

Output-  The  following  four  parameters  specify  the  information 

Option  to  be  included  in  the  DICTIONARY.  The  MN0"  prefix  on 

a parameter  specifies  that  such  information  not  be 
included  for  vhe  tiane(s). 


D ESC F I PTIC-N  (DESC)  , 

NODESCF I PTION  (NDPSC)  Defaul*  : DESCRIPTION 

KEYWORDS  (KEY)  , NOKEYWORDS  (N KEY) 

Default;  KEYWORDS 


EFSPONSIELE-PD  (r  PC)  , 

NuFESPCNSTBLI-Pb fFFPP)  Default:  RESPONSIBLE- PP 


SYNONYMS  (SYN)  , NOSYNOKYMS  (NSYN) 

Default:  SYNONYMS 


* The  name  of  the  defaul*  file  is  installation  dependent  and 
consequently  is  ‘liven  in  Appendix  F. 
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NUK-SPACE  (NS)  =inteqer  Default:  NUM-SPACE*2 


For  ease  in  readinq,  the  number  of  lines  skipped 
between  dictionary  entries  can  be  modified  by  varyincj 
this  parameter.  NUM-SPACE  nay  take  on  any  value 
between  0 and  1C. 

DICTIONARY  N =pa y roll- processing 

DIC?  FILE 
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Command:  DYNAMIC-ANALYSIS  Type:  report  command 

Purpose:  To  produce  the  DYNAMIC  Analysis  report 


Prototype:  DYNAMIC- ANALYSIS  (DA)  [parameter]... 


Parameters : 


Input-  FILE (F)  [ =fdname  ],  NAME (N) =user-name  Default:  FILE 

Data 

When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  ot  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME- GEN . If  an  fdname  is 
given,  that  file  is  used  as  the  input  file  for  the 
command.  The  format  for  the  input  file  must  be  one 
name  per  line.  When  a name  is  given  via  the  NAME 
parameter,  the  analysis  commences  with  that  name  and 
continues  with  all  dynamically  related  names. 
Regardless  of  whether  FILE  or  NAME  is  specified,  all 
names  used  as  input  to  this  command  must  be  PROCESS, 
EVENT,  CONDITION,  or  INPUT  names. 

Output-  DYNAMIC- ANALYSIS- MATRIX  (DAMAT), 

Option  NODYNAMIC-ANALYSIS-MATRIX  (NDAMAT)  Default:  DAMAT 


If  the  NODAMAT  parameter  is  used,  the  DYNAMICS 
ANALYSIS  MATRIX  will  not  be  printed  on  the  report. 


DYNAMICS- ANALYSIS (DANL) , NJDYNAMICS- ANALYSIS (NDANL) 

Default:  DANL 


If  the  NCDANL  parameter  is  specified,  then  the 
analysis  of  the  matrix  is  not  performed  and  no 
diagnostics  will  appear  on  the  report. 

ORDEF  = {BYTYPE-ALPHA}  Default:  ORDEF  = BYTYPE 

[BYTYPE  ) 

{N03YTYPE  } 

The  BYTYPE-ALPHA  option  specifies  the  names  in  the 
rows  and  the  columns  are  sorted  by  oblect  type  and 
alphabetically  within  type.  The  DYTYPE  option  is 
similar  but  the  names  within  each  type  appear  in  the 
order  encountered  during  processing.  The  order  of 
the  oblect  types  are  CONDITIONS,  EVENTS,  INPUTS, 
PROCESSES.  The  NOBYTYPE  option  specifies  the  names 
in  the  rows  and  the  columns  will  be  in  the  order 
encountered  during  processing. 


1 The  name  of  the  default  file  is  installation  dependent 
consequently  is  given  in  Appendix  F. 
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UTILIZES , NOUTILIZES  Default:  UTILIZES 

The  UTILIZES  parameter  specifies  that  the  UTILI7ES 
relationship  between  processes  should  be  shown  in  the 
matrix . 

LINKS=inteqer  Default:  LINKS=1900 

The  LINKS  parameter  specifies  the  maximum  number  of 
connections  between  names  to  be  followed  in 
qeneratinq  the  matrix.  LINKS  may  take  on  any  inteqer 
value  between  1 and  1CC0,  inclusive. 

Examples:  DYNAMIC- AN ALYSIS  N=employee- processinq-init 

NG  S = ' PROCESS  OF  EVENT  OR  CONDITION  OP  INPUT'  NP 
DA 
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Command:  ENTITY-IDFNTIFIEF  Type:  report  command 

Purpose:  To  produce  the  IDENTIFIFF  INFORMATION  REPORT. 


Prototype:  ENTITY-IDENTIFIER (El)  f I CFNTI FIEP ( I)  ) 

(ENTITY  (E)  j [ parameter  ]. . . 

Parameters: 

Input-  FILE (F)[  = f dna  me  ],  NAMF (N) *user-namr  Default:  FILE 

Data 

When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  tile*  are 
used  as  input  to  the  command.  This  file  is  the 
default  rtJNCH  file  for  NAME- GEN.  If  an  fdname  is 
indicated,  that,  file  is  used  as  in  the  input  file  tor 
the  command.  It  a name  is  specified  via  the  NAME 
parameter,  the  report  is  generated  tor  that  name 
alone.  The  format  of  the  input  tile  must  he  one  name 
per  line. 

Input-  T DLNTI F IF  F (I)  , ENTITY  (F)  Default  no  default 

Con*  rol 

Since  no  default  is  allowed,  one  of  the  above  must,  be 
specified.  If  I DFNTI FIFR  is  specified,  the  names- 
used  as  input  to  the  command  must  be  names  used  as 
IDENTI FIT  KS  in  the  data  base.  If  the  ENTITY 
parameter  is  given,  the  names  used  as  input  must  be 
defined  ENTITY  names. 

Messages:  If  neither  the  IDENTIFIER  nor  ENTITY  parameter  is 

specified,  the  message: 


VIST  GIVE  EITHER  ENTITY  OR  IDENTIFIER  PARAMETER 
will  be  given. 

Examples:  FI  N=em pi oyee- number  I 

£1  FILE  ENTITY 


* The  name  of  the  default  til*'  is  installation  dependent  and 
consequently  is  given  in  Appendix  F. 
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Command:  EXTENDED-PICTURE  Type:  report  command 

Purpose:  To  produce  the  FXTFNDFD- PICTUF E report. 

Prototype:  EXTENDED- PICTURE (EP)  [ parameter ].. . 

Parameters: 

Input-  FILE  (F)  [ =f  dname  },  NAME  (N)  =user-na»e  Default:  FILE 

Data 

When  the  FILE  paraaeter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  comand.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdnaae  is 
given,  that  file  is  used  as  the  input  file  for  the 
coamand.  The  toraat  for  the  input  file  must  be  one 
name  per  line.  When  a name  is  given  via  the  NAME 
paraaeter,  the  report  is  produced  only  for  that  name. 
Regardless  of  whether  FILE  or  NAME  is  specified,  all 
names  used  as  input  to  this  command  must  be  PROCESS, 
INTERFACE,  INPUT,  ELEMENT,  GROUP , OUTPUT,  ENTITY,  or 
SET  names. 

Output-  INDEX,  NOINDEX  Default:  NOINDEX 

Data 

The  INDEX  parameter  specifies  the  production  of  an 
index  for  the  EXTENDED  PICTURE  report.  This  index 
consists  of  all  user-defined  names  used  in  the 
report,  in  alphabetical  order,  along  with  the  paqes 
on  which  they  appear  in  the  report. 

Output-  STRUCTURE  (STP) , DATA- FT OW (DF)  Default:  no  default 
Option 


When  the  STRUCTUFE  parameter  is  used,  information  is 
obtained  for  each  input  name  from  UTILIZES,  SUBPAFTS, 
CONSISTS,  and  SUBSETS  statements,  or  their 
complementary  statements.  This  information  is  then 
presented  in  graphical  format.  When  the  DATA-FLOW 
parameter  is  used,  the  graphical  output  shows 
information  obtained  for  each  input  name  from  USED, 
USED  TO  DERIVE,  USED  TO  UPDATE,  RECEIVED,  UPDATES , 
DERIVES,  and  GENERATES  statements  or  their 
complementary  statements.  Since  there  is  no  default, 
either  STRUCTURE  or  DA^A-FLCW  must  be  specified 
unless  the  THREAD  parameter  is  used. 


» The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  F,. 
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FORWARD  (FWD)  , BACKWAFE  (PWD)  Default:  no  default 
DOWNWARD (DOWN)  , UPWARD  (OP) 

It  is  frequently  convenient  to  think  of  FORWARD  and 
BACKWARD  as  referring  to  DATA-FLOW  and  UPWARD  and 
DOWNWARD  as  referring  to  STRUCTURE.  However,  FOFWAFD 
and  DOWNWARD  may  be  used  interchangeably,  as  nay 
BACKWARD  and  UPWARD.  The  FOFWAFD  (or  DOWNWAFD) 
parameter  causes  retrieval  of  information  about  each 
input  name  based  on  UTILIZES,  SUBPARTS,  CONSISTS  and 
SUBSETS  statements  (for  STRUCTURE)  or  USED,  USED  TO 
DERIVE,  USED  TO  UPDATE,  RECEIVED,  UPDATES,  DEPIVES, 
and  GENEFATES  statements  (for  DATA-FLOW) . The 
BACKWARD  (or  UPWAPD)  parameter  causes  retrieval  of 
information  about  each  input  name  based  on  UTILIZED, 
PART,  CONTAINED,  and  SUBSET  statements  (for 
STRUCTURE)  or  USES,  USES  TO  DERIVE,  USES  TO  UPDATE, 
RECEIVES,  UPDATED,  DFFIVED,  and  GENFRATED  statements 
(for  DATA-FLOW).  Since  there  is  no  default,  one  of 
the  above  parameters  must  be  specified  unless  the 
THREAD  parameter  is  used. 

THREAD, NCTHaEAD  Default:  NOTHREAD 

When  the  THREAD  parameter  is  used,  it  implies  the 
DATA-FLOW  FORWARD  pair  hut  limits  its  use  to  the  USED 
TO  DERIVE  relationship. 

LINKS»intega r Default:  LINKS*10C0 

The  LINKS  parameter  specifies  the  maximum  number  of 
links  (connections  between  names)  to  be  followed  in 
producing  the  report.  LINKS  can  take  on  any  integer 
value  between  1 and  1CD0,  inclusive. 

Outnut-  COLUMNS (COLS) ^integer  Default:  CCLUKNS*119 

Format 


The  COLUMNS  parameter  specifies  the  number  of  columns 
to  be  used  for  output.  The  maximum  value  allowed  is 
119,  and  the  minimum  value  allowed  is  38. 

POWS»inteqer  Default:  ROWS*39 

The  ROWS  parameter  specifies  the  number  of  rows  to  be 
used  for  output.  The  maximum  value  allowed  is  34, 
and  the  minimum  value  allowed  is  14. 

HORIZONTAL-BOXES  (HP) «inteqer  Default:  (see  text) 

HORIZONTAL-BOXES  specifies  the  maximum  number  of 
boxes  containing  names  to  be  arranged  across  the 
page.  The  default  value  is  the  largest  possible 
value  for  the  given  value  of  COLUMNS,  and  is  computed 
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Messages : 


Examples: 


Part 


as  the  greatest  inteqer  in  (COLUMNS- 4) /1 7 . 

VPPTICAL-BOXFS (VB) *integer  Default:  (see  text) 

VERTICAL-BOXES  specifies  the  maximum  number  of  boxes 
containing  names  to  be  arranged  down  the  page.  The 
default  value  is  the  largest  possible  value  for  the 
given  value  of  ROWS,  and  is  computed  as  the  greatest 
integer  in  (P0WS-2)/f. 

If  the  H0FI7.0NTAL-B0XFS  value  used  will  not  fit  in 
the  number  of  COLUMNS  specified,  the  message: 

HORIZONTAL-BOXES  TOO  LARGE  FOE  NUMBFF  OF  COLUMNS  ON 
PAGE 


will  be  given. 

If  the  VFRTICAL- BOXES  value  used  will  not  fit  in  the 
number  of  ROWS  specified,  the  message: 


VEFTICAL- BOXES  TOO  LARGE  FOR  NUMBER  OF  FOWS  ON  PAGE 


will  be  given. 

If  none  of  DATA-FLOW,  STRUCTURE  and  THREAD  is 
specified,  the  message: 


NEITHER  DATA-FLOW,  STRUCTURE  NOF  THFEAD  WAS  SPECIFIED 
will  be  printed. 

If  the  THREAD  parameter  is  not  being  used  and  none  of 
FORWARD,  BACKWARD,  UPWARD  and  DOWNWARD  is  specified, 
one  ot  the  following  messages  will  be  printed: 

NEITHER  FORWARD  NOF  BACKWARD  WAS  SPECIFIED 
NEITHER  UPWARD  NOF  DOWNWARD  WAS  SPFCIFIEP. 


EXTENDED-PICTURE  STR  DOWN  N=process1 
FP  FILE  DF  BACKWARD  LINKS=5 


I 

« 
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Command:  FORM ATTED-PROBLEM- STATEMENT  Type:  report  coaaand 

Purpose:  To  produce  the  FORMATTED  PROBLEM  STATEMENT  for  a 

given  name,  or  list  of  naaes  and/or  to  produce  this 
information  in  the  fora  of  PUNCH  data. 

Prototype:  FORMA^TED-PROBLEM-STATEMENT (FPS)  [ parameter  ].. . 
Parameters: 


Input-  FILE  (F)  [ =f  dnaae  ],  NAME  (N)  =user-name  Default:  FILE 

Da  ta 

When  the  FILS  paraneter  is  used  and  no  f dnaae  is 
designated,  the  contents  ot  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME=GEN.  If  an  fdnaae  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  coaaand.  When  a name  is  given  via  the  NAME 
parameter,  the  report  is  produced  only  tor  the  name 
specified.  The  format  of  the  input  file  must  be  one 
naae  per  line. 

Output-  INDEX,  NOINDEX  Default:  NOINDEX 

Data 

The  INDEX  parameter  specifies  the  production  of  an 
index  for  the  FPS.  This  index  consists  of  an 
alphabetical  listing  of  all  user  defined  names  used 
in  the  FORMATTED  PROBLEM  STATEMENT  and  the  page  (s)  on 
which  they  occur. 

PRINT  (P)  , NOPPINT  (NP)  Default:  PRINT 

The  NOPRINT  parameter  specifies  that  no  printed 
output  report  will  be  produced.  The  PRINT  parameter 
specifies  the  production  of  the  FORMATTED  PROBLEM 
STATEMENT. 

PUNCHf  =f dname  ],  NOPUNCH  Default:  NOPUNCH 

The  PUNCH  parameter  specifies  that  PUNCH  data  should 
be  generated  and  written  into  the  designated  PUNCH 
file.  When  the  PUNCH  parameter  is  used  and  no  fdname 
is  designated,  the  data  is  written  into  the  default 
PUNCH  file.*  This  file  is  the  default  PUNCH  file  for 
the  command.  If  an  fdname  is  indicated,  that  file  is 
used  as  the  PUNCH  file.  With  the  NOPUNCH  parameter 
in  effect,  no  action  is  taken  to  generate  PUNCH  data. 

a 

1 The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 
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Output-  COMMENT  (COM)  , NOCOMMENT  (NCOM)  Default:  COMMENT 
Option 

The  COMMENT  option,  when  in  effect,  specifies  the 
inclusion  of  comments  for  undefined  names.  The 
NOCOM.MEN  T option  suppresses  these  comments. 

DEFIN E (OFF)  , NODEFINF  (NDFF)  Default:  DEFINE 

With  the  DEPINE  option  in  effect,  DFFINE  sections  are 
included  in  the  report.  The  NODF FINE  option 
specifies  that  no  DEFINE  sections  are  included  in  the 
FORMATTED  PROBLEM  STATEMENT . 

DESG(DG),  NODFSG(NDG)  Default:  DESG 

The  DFSG  option,  when  in  effect,  indicates  that 
DESIGNATE  sections  are  provided  for  SYNONYM  names  in 
t.he  FORMATTED  PROBLEM  STATEMENT.  The  NODFSG  option 
suppresses  the  production  of  such  output. 

EMPTY,  NOEMPTY  Default:  (see  text) 

When  EMPTY  is  in  effect  (the  default  when  the  PUNCH 
parameter  is  also  used)  the  PUNCH  file  is  emptied 
before  PUNCH  data  is  written  into  it.  When  NOEMPTY 
is  in  effect  (the  default  when  PUNCH  is  not  used)  no 
action  is  taken  to  empty  the  PUNCH  file. 

ALL-STATEMENTS (AS) ,N0AIL- STATEMENTS  (NAS) 

Default.:  NOALL-  STATEMENTS 

The  ALL- STATEMENTS  option  specifies  that  all  legal 
statements  for  each  section  will  be  printed  in  the 
FORMATTED  PROBLEM  STATEMFN?  whether  information  was 
supplied  or  not. 

DLC-COMMENT (DLCC)  , NPDIC-COMMENT  (NDLCC) 

Default:  DLC-COMMENT 

When  the  DLC-COMMENT  parameter  is  in  effect,  each 
name  in  the  Formatted  Problem  Statement  includes  a 
comment  which  indicates  the  date  and  time  ot  the  last 
chanqe  made  to  that  name.  The  NGDLC-COMMENT 
suppresses  the  printing  of  these  cornmnuts. 

LINE-NUMDEFS  (LNS)  ,NOLINE- NUMBEFS (NINS) 

Default:  LINF-NUMBEFS 


Specifies  whether  or  not  line  numbers  are  to  be 
produced  in  the  printed  output. 

PFINTEOF  (PEOF)  ,NOPPTNTFOF  (NPEOF)  Default:  PFINTFOF 
Specifies  whether  an  extra  line  containing  TOF  ir.  to 
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be  produced  at  the  end  of  the  output. 

COMPLEMENTAR  Y-STATFKENTS  (COKP) 

NOCOMPLEMENT ARY- STATEMENTS (NCOMP) 

Default:  COMFLEMENTAFY- STATEMENTS 

Specifies  whether  complementary  statements  are  to  be 
produced.  If  the  NOCOMPLEMENTAP Y-STATEMENTS  option 
is  in  effect,  then  the  number  of  statements  and  lines 
in  the  output  is  the  minimum  which  contains  all  the 
information  in  the  data  base. 

Output-  AHARG  (AM) =inteqer  Default:  AMARG=10 

Format 

The  AMARG  parameter  indicates  the  column  at  which  the 
first  name  of  a name  pair  is  to  be  outputted.  An 
example  of  a name  pair  can  be  found  in  the  ATTRIBUTE 
statement  where  the  syntax  requires  an  ATTRIBUTE  name 
and  ATTRIBUTE-VALUE.  AM AEG  must  take  on  some  value 
greater  than  SF.AFG  and  less  than  BMAPG. 

BMAPG(BM) ^integer  Default:  BM ARG=25 

The  BKARG  parameter  indicates  the  column  at  which  the 
second  name  of  a pair  is  to  be  outputted.  BMARG  must 
take  on  some  value  greater  than  AM  AEG  and  less  than 
RNMAFG- 30. 

CMAFG  (CM) ^integer  Default:  CMAPG=1 

The  CMARG  parameter  specifies  the  number  of  columns 
from  SKAFG  the  text  (comment  entry)  for  a comment 
entry  statement  begins.  CMARG  must  take  on  some 
value  greater  than  0 and  less  than  FMAFG-72. * 

HMAFG  (HM) =integer  Default:  HM ARG=40 

This  parameter  specifies  the  column  where  the  user 
defined  name  in  a section  header  statement  are  to  be 
printed  on  the  output.  HMARG  must  take  on  some  value 
greater  than  SNAPG  and  less  than  PMAPG-30.1 

NEW-  LI  NS  (NL)  , NONFW-LINE  (NNL)  Default:  NONEW-LINE 

Whefc  the  NEW-LINE  parameter  is  given,  the  first  name 
of  a name  list  associated  with  a statement  will 
appear  or.  the  line  succeeding  the  statement 
identifier  (name  of  the  statement) . The  NONEW-LINE 
parameter  initiates  the  list  on  the  same  line  as  the 
statement  identifier. 


1 FMARG  has  the  value  119  unless  changed  at  the  installation. 
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N EW-  PAGE  (N  PG)  , NONFW-PAGE  (NNPG) 

Default:  NONEW- PAGr 

When  given,  the  NEW-PAGF  parameter  specifies  that 
each  section  of  the  FPS  he  printed  on  a separate 
pane.  NCNEW-PAGE  signifies  that  the  sections  will 
follow  one  another  on  a page  within  the  page  size 
restrictions.  In  any  case,  interrupted  sections  will 
be  continued  on  succeeding  pages. 

NMARG(NM) =inteqer  Default:  NMARG=23 

The  NMARG  parameter  indicates  the  column  in  which  the 
name  or  first  name  of  a name  list  for  any  statement 
will  be  outputted.  NMARG  must  take  on  some  value 
qreater  than  SMARG  and  less  than  SNMAPG-37. 

ONE- PER- LINE  (OPL)  , SE VER A L- PER- LIN E (SPL) 

Default:  ONE-PER-LINE 

The  ONE-PER-LINE  option  indicates  that  the  names  in  a 
name  list  for  any  statement  will  appear  on  succeeding 
lines.  SEVERAL- PER- LINE  option  signifies  that  names 
in  a name  list  will  appear  on  the  same  line. 

RNMARG (RM) =integer  Default:  RNM APG*7C 

Specifies  the  right-hand  margin  for  names  in  a name 
list,  when  the  SE VEFAL- PFP-LI NE  parameter  is  in 
effect.  RNMARG  must  take  on  some  value  greater  than 
MAX  (BMARG,  NMAF.G)*29  and  less  than  FMARG-30.' 

SMARG (SM) =integer  Default:  SMARG  = 5 

The  SMARG  parameter  indicates  the  column  in  which  the 
statement  identifier  (name  of  the  statement)  will  be 
started.  SMARG  must  take  on  some  value  greater  than 
* and  less  than  MIN  (AMARG,  NMARG). 

Examples:  FPS  N=f i eld-check-new 

FPS  FILE 


1 RMAFG  has  the  value  119  at  the  installation. 
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Command : 

Purpose: 

Prototype: 

Paraaeters 

Out  put- 
Data 


Output- 

Data 


Examples: 


Part 


PFEQUENCY  Type:report  command 

To  produce  the  FREQUENCY  REPORT. 

FREQUENCY  (FREQ)  [Parameter]... 


1 

I ’ 

I I 


INDEX, NOINDEX  Default:  NOINDEX 

The  Index  parameter  specifies  production  of  an  index 
for  the  frequency  report.  This  index  consists  of  all 
user  defined  names  used  in  the  report  in  alphabetical 
order  and  the  pages  on  which  they  appear  in  the 
report . 

ORDER  = (ALPHA  } Default;  OPDEE=BYTYPE 

(BYTYPE) 

With  ORDER  equal  to  ALPHA,  the  report  presents  the 
names  within  INTERVAL  in  alphabetical  order  by  name. 
BYTYPE  signifies  that  the  names  are  qrouped  by  name 
type  within  INTERVALS  with  the  types  alphabetically 
ordered  and  names  within  the  same  type  ordered 
alphabetically  by  name. 

NEW- PAGE  (NPG)  ,NONEW-PAGE  (NNPG)  Default:  NONEW-PAGE 

When  the  NEW-PAGE  parameter  is  in  effect,  each 
complete  data  structure  in  the  report  will  start  on 
separate  page.  When  the  NONEW-PAGE  parameter  is  in 
effect,  the  data  structure  will  follow  one  another 
within  page  size  restrictions.  Interrupted 
structures  will  be  continued  on  succeeding  pages. 

FREQUENCY  OR  DEE  = ALPH  A NEW-PAGE  INDEX 
FREQ 
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Comand: 

Purpose: 

Prototype: 

Parameters 


Examples: 


HELP 

To  provide  the  on-line  user  with  a list  of  possible 
commands  for  UFA  or  information  about  the  parameters 
for  a particular  UFA  command. 

HELP  [parameter]... 


Command-name  Default:  (see  text) 

If  no  command-name  is  qiven,  a list  of  currently 
available  tlRA  commands  is  given.  If  a comm«and-name 
is  given,  then  the  parameters  for  that  command  are 
presented.  Abbreviations  for  the  command-name  are 
also  acceptable. 

SHORT,  LONO  Default:  SHORT 

If  SHORT  is  qiven,  only  the  parameters  for  the  given 
command  are  printed.  If  LONO  is  qiven,  explanations 
of  the  various  parameters  aie  also  printed. 


HELP  FPS  LONO 
HELP  CONTENTS 
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IN  POT- P SL  Type:  modifier  comiand 

To  add  information  to  the  UFA  data  base  to  expand  or 
modify  the  problem  statement.  A permanent  record  ot 
the  change  can  he  qenerated  in  the  form  of  the  AS-IS 
SOUFCE  LISTING  and  UFA  CFOSS  FEFEPENCE. 

INP'JT-PSL  (IP)  (parameter]... 


INPUT (I) *f dname 


Default:  INPUT=terminal 


When  INPUT  is  specified,  the  contents  of  the 
desiqnated  fdname  are  used  as  input  to  the  command. 
This  input  must  be  in  the  format  of  legal  UFL 
statements  as  specified  by  Part  II,  UFL  User's 
Manual.  Tho  EOF  statement  terminates  input.  It  the 
INPUT  parameter  is  not  specified,  input  is  read  from 
the  terminal  so  that  the  URL  statements  can  be 
entered  interactively. 

TBFEF(D),  NODBFFF  (ND)  Default:  DPFEF 

The  DBF  EF  parameter  allows  the  referencing  of  the 
data  base  by  UFA  in  its  syntax  and  semantic  analysis. 
When  qiven,  NODBFEF  allows  the  analyzer  to  only 
perform  a syntax  check  of  the  input. 

UPDATE  (U)  , NO  UP  TATE  (NU)  Default:  NOUPDATE 

With  the  UPDATE  parameter  qiven,  the  input  will 
update  the  UFA  data  base.  NOUPDATE  indicates  that 
the  data  base  is  not  to  be  chanqed. 

SOUFCE  (S)  , NCSOUFCE  (NS)  Default:  SOUFCF 

When  the  SOUFCE  parameter  is  in  effect,  AS-IS  SOUFCE 
LISTING  of  the  input  UFI  is  produced.  When  the 
NOSOUFCE  parameter  is  qiven,  the  listing  is  not 
produced . 

XFEF(X)  , NOXFEF(NX)  Default:  NOXFFF 

XFEF  specifies  that  a UFA  CFOSS  F2FFRFNCE  is  to  be 
qenerated  for  the  AS-IS  SOUFCE  LISTING.  This 
consists  of  a list  of  all  user  defined  names  from  the 
input  file  and  the  line  numbers  on  which  they  occur 
in  the  AS-IS  SOUFCE  LISTING. 

INPU1-PSL  XREF  UPDATE 
IP  I! 
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Command:  INTERVAL-CONSISTENCY  Type:  report  command 

Purpose:  To  produce  the  INTEFVAL  CONSISTENCY  FEPOFT 

Prototype:  INTERVAL-CONSISTENCY (IC)  [parameter]... 

Parameters : 

Input-  FILE  (F)  [ =f dname  ],  NAME  (N)  = use  r- name  DetaultjFILF 
Data 

When  the  FILE  paLameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  coamand.  This  file  is  the 
default  PUNCH  file  for  NAflE-GEN.  If  an  fdnane  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  coamand.  When  a name  is  given  via  the  NAME 
parameter,  the  report  is  produced  only  for  the  name 
specified.  The  format  of  the  input  file  must  be  one 
name  per  line.  The  names  given  as  input  to  this 
command  must  be  INTEFVAL  names. 

Output-  INDEX, NOINDEX  Default:  NOINTEX 

Data 

The  INDEX  parameter  specifies  the  production  of  an 
index  for  the  report  consisting  of  an  alphabetical 
listing  of  all  names  used  in  the  report  and  the  pages 
on  which  they  appear. 

output-  LFVELS=  (integer]  Default : LEVELS=ALL 

Option  (ALL  ] 

The  LEVFLS  parameter  specifies  the  lowest  level  of 
subordinate  INTEFVAL  names  to  be  printed.  The  ALL 
value  indicates  that,  all  subordinate  names  should  be 
printed,  LEVELS  can  take  on  any  integer  value  from  1 
to  100. 

Examples: 

INTEFV AL-CONSISTENCY  N=year 

NG  S = " INTEF  VAL"  NP 
IC  F LEVELS^  3 


1 The  name  of  the  default  file  is  installation  dependent  an  1 
consequently  is  given  in  Appendix  E . 
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Command:  KWIC  Type:  report  command 

Purpose:  To  produce  a KWIC  INDEX  foL  a list,  of  names. 

Prototype:  KWIC  [parameter]... 

Parameters: 

Input-  FILE (P)  [ =f dnaie  ] Default:  FILE 

Data 

When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdname  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  comand.  The  format  of  the  input  file  must  be  one 
name  per  line. 

Output-  DIF=integer  Default:  DIF=20 

Format 

DIF  is  the  number  of  spaces  allowed  between  the 
keyword  and  the  rest  of  the  name  as  it  appears  in  the 
output.  DIF  must  take  on  some  value  greater  than  1 
and  less  than  53. 

Examples:  KWIC  DIF=10 

KWIC 


i The  name  of  the  default  file  is 
conseguently  is  given  in  Appendix 


installation  dependent  and 
E. 
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Command:  LIST-CHANGES  Type:  report  command 

Purpose:  To  produce  the  LIST  CHANGES  FEPOFT 

Prototype:  LIST-CHANGES  (LC)  [parameter]... 

" PRINT  ( P)  , NOPRINT(NP)  Default:  PFINT 


Output- 

Option  When  the  PFINT  parameter  is  in  effect,  the  list  of 

changes  is  printed  alonq  with  the  report.  This 
includes  the  change  sequence  number,  the  name  of  the 
command  which  chanqed  the  data  base,  and  the  date  and 
time  of  the  session  in  which  the  change  was  made. 

USEF,  NOUSER  Default:  NOUSEF 

When  the  USER  parameter  is  in  effect,  the  list  of 
changes  is  printed  on  the  terminal  (or  the  line 
printer  in  batch  mode) . This  is  useful  when  one 
wishes  to  examine  the  list  of  changes  at  the  same 
time  the  report  is  being  produced  on  the  line 
printer,  for  instance. 
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Command: 


NAME-GEN 


Type:  report  command 


Purpose:  To  produce  the  NAME-GIN  report  and/or  retrieve 

certain  names  to  be  put  in  a PUNCH  file  and  used  as 
input  to  other  commands. 

Prototype:  NAME-GEN  (NG)  [parameter].,. 


Parameters : 

Output- 

Data 


Output- 

Option 


PRINT  (P)  , NOPRINT  (NP) 


Default:  PRINT 


The  PRINT  parameter  initiates  the  production  of  the 
Name  Generation  Report:  NOPRINT  suppresses  printing 
of  the  report. 


PUNCHf  =fdname  ],  NOPUNCH 


Default:  PUNCH 


The  PUNCH  parameter  specifies  that  PUNCH  data  should 
be  generated  and  written  into  the  designated  PUNCH 
file.  When  the  PUNCH  parameter  is  used  and  no  fdname 
is  designated,  the  data  is  written  into  the  default 
PUNCH  file. * This  file  is  used  as  the  PUNCH  file. 

With  the  NOPUNCH  parameter  in  effect,  no  action  is 
taken  to  generate  PUNCH  data. 


EMPTY,  NOEMPTY 


Default:  (see  text) 


When  EMPTY  is  in  effect  (the  default  when  the  PUNCH 
parameter  is  also  used)  the  PUNCH  file  is  emptied 
before  the  list  of  names  is  written  into  it.  when 
NOEMPTY  is  in  effect  (the  default  when  PUNCH  is  not 
used)  no  action  is  taken  to  empty  the  PUNCH  file. 
When  PUNCH  and  NOEMPTY  are  specified  together,  the 
punched  output  appears  at  the  end  of  the  list  of 
names  already  in  the  file. 

TIME-OF-LAST-CHANGE  (TLC)  , NOTIME-OF- LAST-CHANGE (NTLC) 

Default:  NOTIME-OF- LAST- CHANGE 

When  this  parameter  is  specified,  the  time,  date  and 
nature  of  the  last,  change  will  appear  with  each  name 
in  the  printed  output  (Put  not  in  the  PUNCH  file) . 

SELECTIONS (S) *• (boolean  expression)'. 


INPUT  (I) [ *fdname  ] 


Default:  I N PUT*ter mina 1 


"'he  SELECTION  parameter  is  used  to  retrieve  names  of 
particular  name  types  or  which  meet  various  selection 
criterion.  The  contents  of  the  boolean  expression 


1 The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 
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specifies  the  types  of  names  to  be  retrieved  and  how 
they  are  to  be  selected. 


If  the  boolean  expression  (without  primes)  is  stored 
in  a file,  the  expression  may  be  used  to  select  names 
when  the  file  is  specified  by  the  INPUT  patameter. 


A boolean  expression  consists  of  the  following 
objects : 


1 . Operands 

An  explanation  of  each  operand  is  given  below. 


NAME-TYPE 

The  following  name  types  may  be  used  as  operands: 


ATTRIBUTE 

ATTRIBUTE-VALUE 

CLASSIFICATION 

CONDITION 

ELEMENT 

ENTITY 

EVENT 

GROUP 

INPUT 


INTERFACE 

INTERVAL 

KEYWORD 

MAILBOX 

MEMO 

OUTPUT 

PPOBLEM-DEFINEF 

PROCESS 

PROCESSOR 


R EOUSRC E 

RESOURCE- US AGE- PARAMETER 

SECURITY 

SET 

SOURCE 

SUBSETTIKG-CEITEFION 

SYSTEM- PARAMETER 

TRACE-KEY 

UNDEFINED 

UNIT 


ALL 


When  the  ALL  operand  is  specified,  the  names  of  all  name 
types  except  SYNONYM  and  UNDEFINED  will  be  presented. 


TOTAL 


When  the  TOTAL  operand  is  specified,  every  name  in  the  data 
base  will  be  presented. 


BASIC 


When  the  BASIC  operand  is  specified,  the  basic  names  will 
be  included  in  the  output.  The  "Basic"  names  are  those 
names  which  are  not  SYNONYMS. 
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UNDEFINED 

When  t he  ‘UNDEFINED  operand  is  specified,  the  undefined 
names  wil>l  he  presented. 


ATTR  =a  ttr-nama[  , value  ] 

When  the  .ATTR  operand  is  specified,  those  names  with  the 
given  user- name  as  an  ATTRIBUTE  are  selected  to  be  part  of 
the  output.  The  user-name  must  be  a name  defined  as  an 
ATTFIBUTE  in  the  iata  base. 

If  an  ATTR IB UTt- VALUE  is  specified  as  part  of  the 
user-name,  then  only  those  names  with  the  given  user-name 
as  an  ATTRIBUTE-VALUE,  for  the  ATTRIBUTE  designated  by  the 
ATTR  parameter,  are  selected  to  be  part  of  the  output.  The 
user-name  must  be  an  ATTFI BUTE- VALUE  name  in  the  data  base. 


SUBPARTS-OF (SO) = user-name( , level J 

All  names  which  belong  to  the  SUBPARTS  structure  for  a 
given  name  (as  would  be  retrieved  for  the  STRUCTURE  report) 
can  he  retrieved  by  specifying: 


SUBPAPTS«OF=name 


where  the  name  is  an  INPUT,  OUTPUT,  PROCESS  or  INTERFACE 
name  which  has  SUBPAFTS  information  defined  for  it.  The 
number  of!  levels  to  go  down  and  retrieve  names  to  present 
in  the  report  is  specified  by  the  SUBLEVEL  parameter  or  by 
attaching  a command  a level  number  after  the  user-name  with 
the  SUBPAPTS-OF  parameter. 


If  SUBLFVEL=ALL,  then  all  levels  of  names  are  presented. 

If  SUBLEVEL®  1 , then  only  those  names  which  are  PART  OF  the 
SU8PARTS-0F  name  are  presented.  The  following  picture  may 
clarify  the  association  between  the  value  of  SUBLEVEL  and 
the  name?  presented. 


S5 


S8 


S9 


SI 

FUBPARTS-OF  name 

S2 

S3 

S4 

FUBLE VEL=1 

S6 

S7 

SUBLEVEL=2 

Si U S11  SUBLEVEL®  3 


SUBLEVEL=AI L 


(Generation  of  the  report  with  ? UBP ARTS-OF  = S1  and  SUBLEVEL=3 
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would  present  S2 , S3,  S4,  S5,  S6,  57,  SB,  S9 , S10  and  S11 
in  the  report.  Generation  ot  *he  report  with 
STJBPAFTS-0F  = S1  AND  SUBLEVEL=1  would  present  the  names  S?, 

S3  and  S4 . If  >ither  the  level  nor  SUBLEVEL  parameter  are 
specified,  the  default  is  ALL  levels. 


SYNONYMS 


When  the  SYNONYMS  operand  is  specified,  all  SYNONYMS  are 
presented  for  each  name  retrieved  in  the  report  in  addition 
to  the  basic  form  of  the  name.  if  only  the  SYNONYMS  are 
desired,  the  basic  names  may  be  suppressed  by  specifying 
the  NOPASIC  and  SYNONYM  parameters.  With  standard  defaults 
in  effect,  the  BASIC  and  NOSYNONYM  parameters  are  used. 


KEY=user-name 

When  the  KEY  operand  is  specified,  those  names  with  the 
given  user-name  as  a KEYWOFD  are  selected  to  be  part  of  the 
output.  The  user-name  »usf  be  a name  defined  as  a KEYWORD 
in  the  data  base. 


MAX-CHANGE- NUMBER (MAXC) ={intege r|LA ST |LAST- integer} 

This  parameter  retrieves  all  names  with  a change  number 
less  than  or  equal  to  the  specified  integer.  LAST-integer 
should  not  result  in  a negative  value.  The  default  if  this 
criteria  is  not  given  is  LAST. 

MIN- CHANGE- NUMBER  (MINC)  = (integer | LAST | LAST-integer} 

This  parameter  retrieves  all  names  with  a change  number 
greater  than  or  equal  to  the  specified  integer. 

LAST-integer  should  not  result  in  a negative  value.  The 
default  if  this  criteria  is  not  given  is  1. 


PD=user-namme 

When  the  PD  operand  is  specified  those  names  with  the  qiven 
user-name  as  a PROBLEM-DtFJNEF  are  selected  to  be  part  of 
the  output.  The  user-name  must  be  a name  defined  as  a 
PROBLEM- DEFINEP  in  the  data  base. 


SOURCE* user- name 

When  the  SOURCE  operand  is  specified,  those  names  with 
qiven  user-name  as  a SOUFCF  will  be  included  in  the  output. 
The  user-name  must  be  defined  as  a SOURCE  in  the  data  base. 
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SECURITY* user- name 

When  the  SECURITY  operand  is  specified,  those  naaes  with 
given  user-naae  as  a SECURITY  will  be  included.  The  user- 
name  must  be  defined  as  SECURITY  naae  in  the  data  base. 

USAGE*  fID | IDENTIFIER) 


When  the  USAGE  operand  is  specified,  those  naaes  which  are 
used  as  IDENTIFIERS  in  the  data  base  are  selected  to  be 
part  of  the  output.  The  syntax  of  the  Lanquage  only  allows 
ELEMENT,  GROUP  and  UNDEFINED  names  to  be  IDENTIFIERS. 


2. 

An  explanation  of  each  operator  is  given  below. 


NOT,  - 

The  NOT  operator  placed  before  an  operand  specifies  that 
the  names  associated  with  that  operand  will  not  be 
retrieved.  For  example,  a boolean  expression  of  the  form 
NOT  PROCESS  means  that  all  names  in  the  data  base  except 
for  PROCESS  names  will  be  retrieved. 


AN  D,  F>  ,♦ 

The  AND  operator  specifies  that  any  name  retrieved  from  the 
data  base  must  meet  the  criterion  designated  before  and 
after  the  AND  operator.  For  exaniple,  a boolean  expression 
of  the  form  PROCESS  AND  KEY*level-1  means  that  any  name 
retrieved  must  be  a PROCESS  name  as  well  as  have  the 
KEYWORD  "level-1"  attached  to  it. 


0P,|  ,♦ 

The  OF  operator  specifies  that  any  name  retrieved  from  the 
data  base  must  either  meet  the  criterion  designated  before 
the  OR  operator,  or  after  the  operator,  or  both.  For 
example,  a boolean  expression  of  the  form  PROCESS  OF 
KEY*level-1  means  that  any  name  retrieved  must  be  either  a 
PROCESS  name,  or  have  the  KEYWORD  "level-1",  or  be  both  a 
PROCESS  and  have  the  KEYWORD  "level-1". 


3.  Other  Notations 
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Braces  nay  be  used  to  group  operands  and  operators  in  a 
boolean  expression. 

The  following  rules  apply  to  the  fornation  of  boolean 
expressions  to  be  used  with  the  SELECTION  parameter  of  the 
NAME-GEN  command. 

The  following  notation  is  used  to  define  a boolean 
expression: 

exp  - boolean  expression 
opa  - operand 
opr  - operator 

1)  A boolean  expression  (exp)  can  only  be  in  one  of  the 
following  forms: 

a)  opd 

b)  1 -»  exp 

c)  (exp) 

d)  exp  opr  exp 


2)  A boolean  operator  (opr)  must  be  one  of  the  following 
(equivalent  operators  are  listed  in  parentheses): 


a)  6 (AND,*) 

b)  I (OP,*) 


3)  A boolean  operand  (opd)  must,  be  one  of  the  allowable 
options  for  the  SELECTION  parameter  as  listed  below: 

a)  name-type 

b)  KEY=user-name 

c)  PD=user-name 

d)  SOUFCE=user-name 

e)  SECURITY=user-name 

f)  USAGE=  (ID|  IDENTIFIER) 

g)  ATTR=user-name 

h)  ATTP =user-name , user-name 

i)  ATTP =user-name, integer 

■j)  StlBP  APTS-OF  (SO)  =user-name 

k)  SUBPARTS- OF (SO) =user-name , ALL 

l)  SUBPAPTS-OF (SO) =user-narae, integer 

m)  SUBLEVEL(SL)  = {ALL } integer ) 

n)  MAX- CHANGE- NUMBER  (KAXC) * { intege r | LAST | LAST-integer) 

o)  MIN- CHANGE- NUMBER (KINC)  = (integer | LAST | LAST-inteqer } 


1 The  form  exp"  can  also  be  written  as  "not  exp"  or  "-*exp". 
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A name-type  option  can  be  any  of  the  following: 


ATTFIBUTE  (ATTS) 

AT TRIBUTE- VALUE  (ATTV) 
CLASSIFICATION  (CLS) 
CONDITION  (COND) 
ELEMENT  (ELE) 

ENTITY  (ENT) 

EVENT  (EV) 

GPOnP  (GR) 

INPUT  (INP) 

INTERFACE  (INTF) 
INTERVAL  (1ST) 

KEYWORD  (KEY) 

HAILBOX  (BOX) 

MEMO 

OUTPUT  (OUT) 
PROBLEM-DEFINER  (PD) 
PROCESS  (PROC) 

PROCESS  (PEOC) 


PROCESSOR (PRCR , PROCR) 
REAL-NORLD-ENTITY  (RUE) 
RELATION  (FLN) 

PESOUFCE(RSC) 

FESOUPCE-USAGE-PAFAMETER  (PUP) 
SECURITY  (SEC) 

SET 

SOURCE  (SRC) 

SUBSETTING-CRITERION  (SSCN) 
SYSTEM-PARAMETER  (SYSP) 
TRACE-KEY  (TK) 

UNDEFINED 

UNIT 

ALL 

TOTAL 

BASIC 

SYNONYM  (SYN) 


The  rules  which  must  be  followed  in  specifying  these 
boolean  expressions  are  as  follows: 


1)  Any  number  of  blanks  in  a boolean  expression  aay  occur: 

a)  on  either  side  of  an  operand 

b)  before  and  after  the  symbol  "■»" 

c)  before  and  after  the  syabols  " and  ")H 

d)  on  either  side  of  an  operator 

2)  No  blanks  aay  occur  within  an  operator  and  no 
substitutes,  other  than  the  specified  syabols  are  allowed 
to  represent  operators, 

3)  No  blanks  aay  occur  within  an  operand  and  no  operands 
other  than  the  specified  operands  aay  be  used. 


4)  Blanks  must  delimit  the  operators  "AND**,  "OR",  and  "♦H. 

5)  Assume  that  AND  has  precedence  over  OF  when  parentheses 
are  not  qiven.  For  example,  the  expression  ELEMENT  AND 
GROUP  OP  KEY  = low  is  interpreted  as  (ELEMENT  AND  GPOUP)  OR 
KEY=low  rather  than  ELEMENT  AND  (GROUP  OR  KEY=low) . 

6)  A is  assumed  to  belong  to  the  immediately  following 
operand  unless  specified  otherwise.  For  exaaple,  the 
expression  -»  PROCESS  OF  ELEMEN"  would  be  interpreted  as  {-• 
PROCESS)  OR  ELEMENT  rather  than  - { PROCESS  OR  ELEMENT). 

7}  A boolean  expression  may  be  continued  over  several  lines 
when  the  last  character  on  the  line  is  a dash  (-) , when  it 
appears  in  the  ordinary  command  stream.  when  INPUT*  is 
specified,  the  boolean  expression  must  appear  in  card  image 
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format,  with  no  operands  broken  between  lines  and  no  dashes 
for  continuation. 

The  following  boolean  expressions  are  illegal  for  the 
NAME-GEN  command: 

1)  PROCESS  OF  { GROUP  KEYWOFD=level- 1} 

No  operator  between  operands  GPOUP  and  KEYWORD 
The  following  boolean  expressions  are  legal: 

1)  ELEMENT  OF  GROUP  OF  ENTITY 

2)  PFOCESS  AND  KEYW0FD=s1  OF  KEYW0RD=level-1 

3)  { GROUP  | ELEMENT  } AND  ATTF=type, character 


Output- 

Format  OFD£F={BYTYPE| ALPHA | a t t r- na m e | TI M£-0 F- L AST- CH A NG E) 

Default:  OEDEF=BYTYPE 

The  ORDER  parameter  specifies  how  the  names  retrieved 
are  to  be  ordered  (in  the  PUNCH  file  and  the  report)  . 

When  ORDEF=ALPHA , all  names  retrieved  are  presented 
in  alphabetical  order  by  name.  When  ORDER=BYTYPE , 
all  names  retrieved  are  grouped  by  the  name  types 
associated  with  them.  The  names  types  are  ordered 
alphabetically  as  are  the  names  within  each  name  type 
group.  when  ORDEF=att r-name  or 

OFDEF=attr-name-synonym,  all  names  retrieved  are 
presented  in  alphabetical  order  of  the  values  they 
have  for  the  specified  ATTRIBUTE  name.  Names  which 
do  not  have  the  specified  ATTRIBUTE  are  placed  at  the 
beginning  of  the  list  cf  names. 

When  OFDEF=TIME- OF- LAST- CHANGE,  all  names  retrieved 
are  sorted  on  the  date  and  time  of  last  change.  In 
addition  to  the  four  different  orderings  that  may  be 
specified,  an  ordering  list  may  be  given  which  allows 
up  to  five  levels  of  ordering  on  the  retrieved  names. 
All  options  in  the  list  must  be  separated  by  commas. 
No  blanks  may  appear  in  the  list.  The  names  are 
ordered  first  on  the  first  option  in  the  ordering 
list;  within  that  ordering,  on  the  second  option  in 
the  ordering  list,  etc.  Some  examples  of  using  the 
orderinq  list  are: 

ORDER =BYTYPE, length , type 

CPDEF= level , PYTYFE 

ORDER =BYTYPE,TIFE-CF- LAST-CHANGE 


I 


1 
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Examples 


KG  S = ' PROCESS  AND  KEY=level-2' 

NG  S*'(NOT  PROCESS)  * KEY*level-2' 

NG  S«*  ATT F»occurr ence, unscheduled' 

NG  S=' SO*Security-control-inpufc' 

NG  S= 'SO*security-cont rol-input, 1' 

OED£ R*BYTYPE#occurrences 


f 

f. 
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NAME- LIST  Type:  report  command 

To  produce  the  NAME  LIST  report. 

NAME-LIST  (NL)  [parameter] 


ORDEF=  [ALPHA  ] Default;  ORDEP=BYTYPF 

{BYTYPE] 

If  ORDER=ALPHA  is  specified,  the  list  is  ordered  by 
the  name  of  the  object.  If  OPDER=BYTYPE  is 
specified,  the  order  is  alphabetical  by  name  type, 
with  objects  of  the  same  type  beinq  order  by  name. 

COLUMN  (COL)  = {SYN  } Default:  COLUMN  = TYPE 

{TYPE] 

If  COLUMN=TYPE,  the  TYPE  column  will  be  printed 
before  the  SYNONYM  column.  If  COLUMN=SYNONYM,  the 
SYNONYM  column  will  be  printed  before  the  TYPE 
column . 

TYPE,NOIYFE  Default;  TYPE 

with  the  TYPE  parameter  in  effect,  the  name-type  for 
each  name  in  the  list  will  be  presented.  NOTYPF 
suppresses  the  printinq  of  the  TYPE  column. 

SYNONYM  (EYN)  , NOS YNONYK  (NSYN)  Default:  SYNONYM 

With  the  SYNONYM  parameter  in  effect,  the  SYNONYMS 
for  each  name  in  the  list  will  be  presented. 
NOSYNONYM  suppresses  the  printing  of  the  SYNONYM 
column. 

DATE-LAST-CHANGED  (DLC)  , NODA TE- LAST-CH ANGED (N DLC) 

Default:  DATE- LAST-CHANGED 

When  the  DA TF-LAST-CHANGFE  parameter  is  in  effect, 
the  date  of  last  change  of  each  name  is  printed  out 
on  the  same  line  as  the  name.  The 

NODATE-L AST-CHANGED  parameter  causes  these  dates  to 
be  omitted  from  the  report. 

NAME-LIST 

NL  OFDER=ALPH A NSYN 
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Command:  PICTURE  Type:  report  command 

Purpose:  To  produce  the  TICTUFE  report. 

Prototype:  PICTUFE(PIC)  [parameter]... 

Parameters: 

Input-  FILE  (F)  [ *fdna»e  ],  NAME  (N) =user-name  Default:  FIIF 
Data 

when  the  FILS  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAML-GEN.  If  an  fdname  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  command.  when  a name  is  given  via  the  NAME 
parameter,  the  report  is  produced  only  for  that  name. 
In  any  case,  the  names  used  as  input  to  this  command 
must  be  INT3RFACE,  PROCESS,  SET,  INPUT,  OUTPUT, 
ENTITY.  GROUP  and/or  ELEMENT  names.  The  format  of 
the  input  file  must  be  one  name  per  line. 

Output-  INDEX,  NCINDEX  Default:  NOINDEX 

Data 

The  INDEX  parameter  specifies  the  production  of  an 
index  tor  the  PICTURE  report.  This  index  consists  of 
all  user  defined  names  used  in  the  report,  in 
alphabetical  order  and  the  pages  on  which  they  appear 
in  the  report. 

Output-  DATA  (D)  , NODATA  (ND)  Default:  DATA 

Opt  ion 

With  the  DATA  parameter  in  effect,  information 
applicable  and  available  for  the  qiven  name,  or  list 
of  names  other  than  structure  or  flow  data  is  printed 
on  the  output.  NODATA  inhibits  such  action. 

FLOW,  NOFLOW  Default:  FLOW 

This  parameter  presents  flow  information  in  the 
PICTUFE  report.  It  presents  RECEIVES  and  GENERATES 
information  between  INPUTS  and  OUTPUTS  with  PROCESSES 
and  INTERFACES.  It  also  presents  USES  and  DERIVES 
information  between  PPOCESSES  and  data  (such  as  SFTS, 
ENTITIES,  GROUPS  and  ELEMENTS). 

STFUCTUFE  (STR) , NOSTRUCTUFE  (NSTR)  Default: 

STRUCTURE 


* The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  qiven  in  Appendix  F. 
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When  the  SIPUCTUPE  parameter  is  in  effect,  the 
information  available  in  the  SUBPABTS,  CONSISTS 
and/or  SUBSSIS  statements  and  their  complementary 
statements  for  the  input  name  (s)  appears  in  the 
report , 

PICTUFE  N=paycalc-updat inq 

PIC  N=payroll-processing  NODATA  NOFLCW 
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Co*  aand : 
Purpose : 


PRINT-ATTEIBUTE- VALUES  Type:  report  command 

To  produce  the  ATTRIBUTE  FEPOFT. 

Prototype:  PRINT- ATTRIBUTE- VALUES  (PA  V)  [parameter]... 
Parameters: 


Input-  FILE  (F)  [ =fdname  ],  NAME  (N)  =user-name 
Data 


Default:  FILE 


When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file1  are 
used  as  input  t.o  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME- GEN . If  an  fdname  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  command.  The  input  file  format  must  be  one 
ATTEIBUTE  name  per  line.  When  a name  is  specified  by 
the  NAME  parameter,  the  report  is  generated  for  that 
name  only.  In  any  case,  only  ATTRIBUTE  names  may  be 
used  as  input  to  this  command. 


Examples:  PPINT- ATTEIBUTE- VALUES  FILE 

PAV  N=TYPE 


1 The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  F. 


-jj 
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Command:  PFOCESS- CH A IH  Type:  report  command 

Purpose:  To  produce  the  PFOCESS  CHAIN  report. 

Prototype:  PROCESS-CHAIN  (PC)  [parameter]... 

Parameters : 

Input-  FILS  (F)  ( =fdnaae  ],NAME  (N)  =user-.:ame  Default:  FILE 

Data 

When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  tile1  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME- GEN . If  an  fdname  is 
given,  that  file  is  used  as  the  input  file  tor  the 
command.  The  format  for  the  input  file  aust  he  one 
name  per  line.  When  a name  is  given  via  the  NAME 
parameter,  the  report  is  produced  only  tor  that  name. 
Regardless  of  whether  FILE  or  NAME  is  specified,  all 
names  used  as  input  to  this  command  must  be  EVENT  or 
PROCESS  names. 

Output-  INDEX,  NCINDEX  Default:  NOINDEX 

Data 

The  INDEX  parameter  specifies  the  production  of  an 
index  for  the  PFOCESS  CHAIN  report.  This  index 
consists  of  all  user-defined  names  used  in  the 
report,  in  alphabetical  order,  along  with  the  pages 
on  which  they  appear  in  the  report. 

Output-  LINKS=integer  Default:  LINKS=1CC0 

Option 

The  LINKS  parameter  specifies  the  maximum  number  of 
links  (connections  between  names)  to  be  followed  in 
producing  the  report.  LINKS  can  take  on  any  integer 
value  between  1 and  10  0 C , inclusive. 

DFPEND ING-ON  (DEP),  NO DEPENDING- ON  ( NDEP) 

Default:  NODEPENDING- ON 

When  the  DSPENDING-ON  parameter  is  used,  the  report 
indicates  whether  a DFpFNDING-ON  clause  is  in  effect 
for  a given  relationship. 

F0F- EACH  (FEA)  , N0F0P-EACH  ( NFEA) 

Default:  NOFOF-EACH 

When  the  FOP-EACH  parameter  is  used,  the  report 
indicates  whether  a FOP- EACH  clause  is  in  effect  for 
a given  relationship. 


1 The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  F. 
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COLUMNS (COLS) =integer  Default:  C0LUMNS=119 

The  COLUMNS  parameter  specifies  the  number  of  columns 
to  be  used  for  output.  The  maximum  value  allowed  is 
119,  and  the  minimum  value  allowed  is  38. 

BOHS=integer  Default:  ROWS=39 

The  RONS  parameter  specifies  the  number  of  rows  to  he 
used  for  output.  The  maximum  value  allowed  is  39, 
and  the  minimum  value  is  14. 

HORIZONTAL-BOXES (HB) =integer  Default:  (see  text) 

HORIZONTAL-BOXES  specifies  the  maximum  number  of 
boxes  containing  names  to  be  arranged  across  the 
page.  The  default  value  is  the  largest  possible 
value  for  the  given  value  of  COLUMNS,  and  is  computed 
as  the  greatest  integer  in  (COLUMNS-4) /17. 

VERTICAL- BOXES(VB) =integer  Default:  (see  text) 

VERTICAL-BOXES  specifies  the  maximum  number  of  boxes 
containing  names  to  be  arranged  down  the  page.  The 
default  values  is  the  largest  possible  value  for  the 
given  value  of  RONS,  and  is  computed  as  the  greatest 
integer  in  (FOWS-2)/6. 

If  the  HORIZONTAL— BOXPS  value  used  will  not  fit  in 
the  number  of  COLUMNS  specified,  the  message: 


HORIZONTAL— BOXES  TOO  LAFGE  FOF  NUMBER  OF  COLUMNS  CN 
PAGE 

will  be  given. 

If  the  VERTICAL- BOXES  value  used  will  not  fit  in  the 
number  of  ROWS  specified,  the  message: 

VEFTICAL- BOXES  TOO  LAFGE  FOP  NUMBER  OF  ROWS  ON  PAGE 

will  be  given. 

PROCESS-CHAIN  N=event1 

PC  FILF  LIN  K S =4  INDEX 
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Command:  TROCESS- INPUT-OUTPUT  Type:  report  command 

Purpose:  To  produce  the  PFOCESS  INPU T/OUTPUT  report. 

Prototype:  PFOCFSS- INPUT-OUTPUT  (PPIO)  [parameter]... 
Parameters: 

Input-  FILE  (F)  =[  fdname  ],  NAMF(N)  =user-name  Default:  FILF 
Data 


When  the  FILS  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdname  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  command  and  the  report  is  produced  using  all  the 
names  in  the  file.  When  a single  name  is  specified 
by  the  NAME  parameter,  the  report  is  produced  for 
that  name  alone.  Either  FILF.  or  NAME  can  be  used  hut 
not  both.  In  any  case,  all  the  names  used  as  input 
to  this  command  must  be  PROCESS  names.  The  input 
file  format  is  one  PROCESS  name  per  line. 

Output-  INDEX,  NOINDEX  Default:  NOINDEX 

Data 

When  given,  the  INDEX  parameter  specifies  the 
production  of  an  index  into  the  report.  The  index 
consists  of  all  input  and  output  names  in  the  report, 
in  alphabetical  order  and  the  page(s)  on  which  they 
occur  in  the  report. 

PPINT(P),  NOPRINT  (NP)  Default:  PRINT 

The  NOPEINT  parameter  specifies  that  no  printed 
output  report  will  be  produced.  The  PFINT  parameter 
specifies  the  production  of  the  PROCFSS  INPUT/OUTPUT 
report . 


Output-  DESCRIPTION  (DSSC)  , NODFSCRI PTION  (NDESC) 

Option  Default:  DESCRIPTION 


When  the  DESCRIPTION  parameter  is  in  effect,  the 
comment-entry  associated  with  the  DESCRIPTION 
statement,  for  all  PROCESS  used  as  input,  is 
retrieved  and  printed  on  the  report.  NODESCRIPTION 
specifies  that  this  information  is  not  to  bo 
retrieved. 


* The  name  cf  the  default  file  is  installation  dependent  an  1 
consequently  is  given  in  Appendix  F. 
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PF0C3DURF (PRCD)  , NOPFOCFNJFE  (NPRCD) 

Default:  NOPROCEDtIRE 

When  the  PROCEDURE  parameter  is  specified,  the 
comment  entry  associated  with  the  PROCEDURE 
statement,  for  each  PROCESS  name  used  as  input,  is 
retrieved  and  printed  on  the  report.  With  the 
NOPROCEDURE  parameter  in  effect,  this  information  is 
not  retrieved. 

INPUT(INP),  NOINPUT  (NINP)  Default:  INPUT 

When  the  INPUT  parameter  is  in  effect,  all  the  name 
of  objects  used  as  input  to  each  PROCESS  (i.e.,  nam 
associated  with  the  FFCEIVES  and  USES  statements)  are 
retrieved  and  printed  on  the  report.  The  NOINPUT 
parameter  specifies  that  this  information  is  not  to 
be  retrieved. 

OUTPUT  (OUT),  NOOUTPUT  (NOUT)  Default:  OUTPUT 

When  the  OUTPUT  parameter  is  in  effect,  all  the  names 
of  objects  desiqnated  as  output  from  each  PFOCFSS 
(i.e.,  names  associated  with  the  GENEFATES,  DERIVFS, 
and  UPDATES  statements)  are  retrieved  and  printed  on 
the  report.  The  NOOUTPUT  parameter  specifies  that 
this  information  is  not  ►o  be  retrieved. 

NEW-PAGE  (NPG)  , NONEW-PAGF  (NNNPG) 

Default:  nonew-PAGE 

When  qiven,  the  NEW-PAGE  parameter  specifies  that 
each  section  of  the  PROCESS  INPUT/OUTPUT  report  be 
printed  on  a separate  paqe.  NONFW-PAGE  signifies 
that  the  sections  will  fellow  one  another  on  a page 
within  the  page  sire  restrictions.  In  any  case, 
interrupted  sections  will  be  continued  on  succeeding 
pages. 

PFIO  N*payroll-processinq 
PR  10  F NDESC  NPG  PFCD 
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Command: 
Purpose : 


Prototype: 

Parameters 

Input- 

Data 


PROJECTED-COST-SEPOFT  Type:  report  command 

To  produce  the  PFOJECTFD  COST  FEPOFT  using  the  value 
of  user-defined  system-parameters  and  attributes  in  a 
UFA  data  base. 

The  equation  which  will  be  evaluated  is  input  by  the 
user. 

PROJECTED-COS I- FEPOFT  (PCF) 

{ FSC=resource-name  UNITS=unit-naae  ) 

[ parameter  ]. . . 


FILE  (F) [ =f dname  ],  NAME  (N)  =user- name  Default:FILE 

When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file  are  used 
as  input  to  the  command.  This  file  is  the  default 
PUNCH  file  for  NAKE-GFN.  If  an  fdname  is  indicated, 
that  file  is  used  as  the  input  file  for  the  command. 
When  a name  is  qiven  via  the  NAME  parameter,  the 
report  is  produced  only  for  the  name  specified.  The 
format  of  the  input  file  must  be  one  name  per  line. 

EXPRESSION 

(E) = 'arithmetic  expression' , INPUT (I)[=fdname] 

Default : lNPUT=terminal 

The  EXPRESSION  parameter  is  used  to  designate  an 
equation  to  evaluate  projected  cost.  The  operands  of 
the  arithmetic  expression  are  integers,  user-defined 
system-parameters  and  user-defined  attributes.  INPUT 
parameter  can  be  used  to  designate  a file  which 
contains  an  arithmetic  expression.  If  the  INPUT 
parameter  is  used  and  no  fdname  is  specified,  its 
value  defaults  to  the  terminal. 

Theoperators  of  the  arithmetic  expression  are 
*»ith  the  usual  interpretation.  To 
distinguish  operators  from  the  characters  used  in 
user-name,  all  the  operators  must  be  delimited  by 
blanks. 

In  additionf  the  function  modifiers  LN,  LOG,  and  FXP 
may  be  applied  to  any  part  of  the  expression  by 
prefacing  that  part  with  the  desired  modifier  and 
enclosing  the  part  in  braces  ({})•  These  function 
modifiers  have  the  following  interpretation: 

LN  - modifies  the  expression  within  the  braces  by 

taking  the  natural  logaiithm  of  the  expression 
value. 
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LOG  - modifies  the  expression  within  the  braces  by 

taking  the  base  10  logarithm  of  the  expression 
value. 

EXP  - sodifies  the  expression  within  the  braces  by 
raising  its  value  to  the  power  e , where  e is 
the  base  of  the  natural  logarithms. 

DEFAULT  (DEP) -integer  Default:  DEFAULT-0 

This  paraaeter  gives  the  default  value  to  be  used  if 
some  system  parameter  cccurs  in  the  expression  but 
does  not  have  a numerical  value  assigned  to  it.  If 
no  default  is  given,  a value  of  zero  is  assumed  for 
such  cases. 

Output  INDEX,  NOINDEX  Default:  NOINDEX 

Data 

The  INDEX  parameter  speifies  the  production  of  an 
index  for  the  Projected  Cost  Report.  This  index 
consists  of  an  alphabetical  listing  of  all  user 
defined  names  used  in  the  report  and  the  page(s)  on 
which  they  occur. 

RESOURCE (FSC) -resource-name  Default:  no  default 

The  EESOUFCE  parameter  must  specify  the  name  to  be 
included  on  the  report  as  the  resource  for  which  the 
usage  is  being  computed,  for  example,  money, 
cpu-time,  and  man-power. 

UNITS (U) -unit-name  Default:  no  default 

This  parameter  must  give  the  name  of  the  units  in 
which  the  usage  is  measured,  for  example,  dollars, 
seconds,  man-hours. 


BxaiPles 

PCR  N»hired-employee-report  DFF-1C  FSC=money 

U-S  E«'copies  ♦ many' 


I 
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Command:  PUNCH-COMMENT-ENTF Y Type:  report  command 

Purpose:  To  produce  the  P UNCHED-COMMEN I-ENTFI ES  report  and/or 

punch  the  specified  comment  entries  into  a PUNCH 
file. 

Prototype:  PUNCH-COKMENT-ENTFY  (FCOM)  [parameter]... 

Parameter : 

Input-  FILE  (F)  [ =f  dname  ],  NAME  (N)  =user-na«e 
Data  Default:  FILE 

When  the  FILS  parameter  is  used  and  no  fdname  is 
designated,  the  contents  ot  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdname  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  command.  When  a name  is  specified  by  the  NAME 
parameter,  the  output  is  produced  for  that  name 
alone.  The  format  of  the  input  file  must  be  one  name 
per  line. 

PFINT(P),  NOPFINT(NP)  Default:  PRINT 

The  PFINT  parameter  initiates  the  production  of 

printed  output  for  the  report.  When  the  NOPFINT 
parameter  is  qiven,  the  PUNCH  COMMENT  ENTRIES  report 
is  not  produced. 

PUNCHf  =f  dname  ],  NOPUNCH  Default:  PUNCH 

The  PUNCH  parameter  specifies  that  PUNCH  data  should 
be  generated  and  written  into  the  designated  PUNCH 
file.  when  the  PUNCH  parameter  is  used  and  no  fdname 
is  designated,  the  data  is  written  into  the  default 
PUNCH  file.*  This  file  is  the  default  PUNCH  file  for 
the  command.  If  an  fdname  is  indicated,  that  file  is 
used  as  the  PUNCH  file.  With  the  NOPUNCH  parameter 
in  effect,  no  action  is  ♦•aken  to  generate  PUNCH  data. 

output-  EMPTY,  NOEMPTY  Default:  (see  text) 

Option 


When  EMPTY  is  in  effect  (the  default  when  the  PUNCH 
parameter  is  also  used)  the  PUNCH  file  is  emptied 
before  PUNCH  data  is  written  into  it.  When  NOEMPTY 
is  in  effect  (the  default  when  PUNCH  is  not  used)  no 
action  is  ♦aken  to  empty  t.he  PUNCH  file. 

The  comment  entries  associated  with  the  following 


Output- 

Data 


* The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  T’. 
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types  o t coBwent  entry  stateBents  are  retrieved  when 
qiven  as  paraaeters. 

DFF IVATION (DEH)  , NODEF I VATION  (N  DEP)  TJObtKH  jtl  ION 

DESCRIPTION  (DISC) , NODESCFI PTION  (NDESC) 

NODESCRIPTION 

FALSE-HHILE  (FH)  , NOFALSE- WHILE  <NFW)  NOFALSE- WHILE 

PFOCEDURE  (PFCD)  , NOPFOCEDURE  (NPFCD)  NOPROCEDUFE 

TRUS-HHILE(TW)  , NOTFUE- WHILE  (NTH)  NOTRUE-HHILE 

VOLATILITY (VOL) , NOVOLATILIT Y (N VOL)  NOVOLATILITY 

VOLATILITY-MEMBER  (VCLM)  , NOVCLATILITY-KEMBEE (NVOLM) 

NOVOLATILITY-MEMBEF 

VOLATILITY-SET  (VOLS)  , NOVOLATILITY-SET  (NVOLS) 

NOVOLATILITY-SET 

Exasples:  PCOM  N ^payroll- processing  DISC 

PCOM  F DESC  PFCD 


'1 
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Command : 
Purpose: 

Prototype : 

Parameters 

Input- 
Oar  a 


Messages: 


Examples: 


Part 


FENAML  Type:  modifier  command 

To  change  the  name  of  some  object  in  the  data  base 
and  to  produce  the  RENAME  REPORT  as  a permanent 
record  of  the  change. 

RENAME  (PFN)  (OLD  (0)  =user-naae  NEW  (N)  =user-name) 
(INPUT  (I) *f dname  } 


INPUT (I) =f dname 


Default:  no  default 


For  multiple  name  chanqes,  an  input  file  can  be  used. 
Each  line  of  the  file  must  consist  of  the  old  name 
followed  by  the  new  name.  The  two  names  must  be 
separated  by  one  or  more  blanks. 

OLD  (0) =user-name  Default:  no  default 

The  user-name  specified  here  is  the  name  that  is  to 
be  changed.  This  name  must  be  defined  in  the  data 
base. 

NEW  (N)  -user-name  Default.;  no  default 

The  user-name  specified  here  is  the  name  to  replace 
the  old  name*.  if  the  new  name  is  already  in  the  data 
base,  the  name  will  not  be  changed. 

Fox  a single  chanqe,  both  OLD  and  NEW  must  be  given 
with  legal  values. 


If  neither  INPUT  nor  the  OLD  and  NEW  parameters  are 
specified  the  message: 


MUST  GIVE  OLD  AND  NEW,  OF  INPUT 
will  be  given. 


RENAMF  OLD=employee-code  N E W=employee- number 
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Command:  P EPL ACL- COMMENT- ENTRY  Type:  modifier  command 

Purpose:  To  replace,  for  a qiven  name,  specific  comment 

entries  associated  to  it.  A REPLACED  COMMENT  ENTFIES 
' report  is  also  printed  as  a permanent  record  of  the 

change. 


Prototype:  REPLACE- COMMENT-ENTRY  (FCOM)  [parameter]... 

Parameters: 

Input-  INPUT (I) =fdname  Default:  (see  text) 

Data 

The  designated  fdname  contains  the  new  comment 
entries  that  will  replace  specified  old  comment 
entries  in  the  data  base.  The  required  format  of  the 
file  is  the  same  as  that  punched  by 
priNCH-COKMENT-ENTRY.  If  INPUT  is  not  given,  the 
input  will  be  taken  from  the  default  file.1  This  file 
is  the  default  PUNCH  file  for  PCOM.  For  each  comment 
entry  to  be  replaced,  the  following  format  must  be 
qiven  in  the  input  file: 

name 

comment-entry  tvpe; 


comment  entry  text 


Where  name  is  a name  defined  in  the  data  base,  the 
comment-entr y-type  (e.q.,  DESCRIPTION,  VOLATILITY, 
o*c.)  must  be  followed  by  a semicolon.  The  text 
following  this  must  also  be  followed  by  a semicolon. 
This  sequence  of  lines  can  be  repeated  as  many  times 
as  necessary  in  the  input  file. 

Output-  PR  I NT  (P)  , NOPRINT  (N  P)  Default:  PRINT 

Data 

The  PPINT  parameter  initiates  the  production  of  the 
PEPLACED  COMMENT  ENTRIES  report;  NOPFINT  suppresses 
printing.  The  report,  if  produced,  contains  both  the 
old  and  new  comment  entries. 

Examples:  RCOM  NOPFINT 


1 The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 
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Command : 
Purpose: 
Prototype: 

Parameters 

Input- 
Da  ta 


Analysis- 

Control 


Output- 

Data 


Part 


| 

RESOURCE-CON SUMPTION-A NAI YSIS  Type:  report  command 

To  produce  the  RESOURCE-CONSUMPTION  FEPORT 

RESOURCE-CON  SUMPTION- ANA  LYSIS  (FCA) 

INTEFVAL=user-name  [parameters] 


*ILE (F) [ 

= f dnam 

e ],  N AM E (N) 

=nser-name 

Def 

ault:  FIL 

p 

When  the 

FILS 

parameter 

is  used 

and 

no 

fdname  is 

designat 

ed,  the  contents 

of  the 

def  a 

ult 

file  are 

used 

as  input 

to  the  command. 

Th  is 

f ile 

is 

the  defau 

It 

PUNCH  fi 

le  for 

NAME-GEN. 

If  an 

f dna 

me 

is  indica 

ted , 

that  fil 

e is  u 

sed  as  the 

input 

file 

for 

the  comm 

and 

and  the 

report 

is  produced  usin 

g all 

the  names  i 

n the 

file.  When  a 

single  nan 

e is  specifi 

ed 

by  the  NA 

ME 

paramete 

r,  the 

report  is 

produced  fo 

r t 

hat  name 

alone . 

Either 

FILE  or  N 

AML  can 

be  u 

sed 

but  not 

both . 

In  any  case,  all  the  names  used  as  input  to  this 
command  must  be  PROCESS  names.  The  input  file  format 
is  one  PROCESS  name  per  line.  The  given  process-name 
is  used  as  the  name  of  the  root  process  from  which 
all  subsequent  analysis  proceeds.  The  report  will  be 
produced  only  for  consumption  of  resources  in 
performing  this  process  and  its  component  processes 
as  determined  by  the  PFOCESS-LEVEL  parameter. 


PROCESS- LEVEL  (PL) =(AIL  ] refault:  ALL 

{number) 


This  parameter  specifi 
component  PROCESSES  re 
information  is  used  in 
corresponds  to  the  "de 
connections  that  will 
root- process . If  ALL 
until  the  lowest  level 


es  the  lowest  level  of  the 
lative  to  the  root  name  whose 
the  analysis.  In  short,  it 
pth"  of  UTILIZES  and  SUBPARTS 
be  probed  from  the 
is  in  effect,  probinq  continues 
processes  are  reached. 


INTERVAL  (INT) =user-name  Default:  none 

This  specifies  the  interval  in  terms  of  which  the 
analysis  and  report  production  is  done.  The 
user-name  must  be  an  INTRVAL  name.  All  necessary 
HAPPENS  statements  that  are  used  by  the  Analyzer  must 
he  in  terms  of  this  INTFPVAL,  or  must  be  convertible 
to  it  (throuqh  CONSISTS  OF  statements  in  the  INTRFVAL 
section) . 

BYPROCESSOR (BP) , NOBY PFCCFSSOP (NBP) 

Default:  BY  E ROCESSOF 

When  the  BYPFOCKSSOF  parameter  is  in  effect,  the 
Resource  Consumption  Feport  arranged  by  PFOCESSCF 
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Example: 


name  is  presented.  When  NOB YPPOCESSOR  is  in  effect, 
it  is  not  presented. 

BYRESOURCE  (BR)  , NO  BYRESOURCE  ( NBP) 

Default:  BYEESOURCE 

When  the  RYRESOUFCE  parameter  is  in  effect,  the 
Resource  Consumption  Report  arranged  by  RESOURCE  name 
is  presented.  When  NOBYEESOUPCE  is  in  effect,  it  is 
not  presented. 

INDEX , NOINDEX  Default:  NOINDEX 

The  INDEX  parameter  specifies  the  production  of  an 
index  for  the  Resource  Consumption  Report.  This 
index  consists  of  an  alphabetical  listing  of  all  URL 
user-names  included  in  the  report  and  the  page(s)  on 
which  they  occur. 

PR0CESS3F-KE YWOFD  (PK)  = 

(ALL  } Default:  ALL 

{user-name} 

This  parameter  specifies  that  only  those  processors 
with  a given  key  will  have  processor-resource 
utilization  reports  produced.  The  user-name  must  be 
a KEYWORD  name.  If  ALL  is  in  effect,  all  PROCESSORS 
that  are  used  to  perforin  the  given  process  will  have 
this  report  produced. 

RESOURCE-CON  SUMPTION- ANALYSIS 

N=»a in- processing  INTER VAL= year 

RCA  INTER VAL=month  INDFX  PL=1  PK=hardware 
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Command : 

Purpose : 

Prototype : 

Pa  ramet  er  s 

Input- 

Data 


Ar.a  lysi  s • 
Control 


Output- 

Data 


Examples: 


Part 


SEC UK  I TY- ANA L YSI S Type:  report  command 

To  produce  the  SECURITY  ANALYSIS  report. 

SECURITY- AN A LYSIS  (SEC A)  [parameters  ] 


?ILL(r)  [=fdnun:e],  NAM"  (N)  = user-name  Default:  FILE 

When  h •>  FILL  parameter  is  used  and  no  fdn.  •»  is 
designated,  t.h*  contents  01  the  default  ti.  are  used 
as  iu[>ut  to  the  command.  This  file  is  the  default 
PUNC.I  file  for  NAME- GEN.  If  an  fdname  is  indicated, 
that  file  is  used  as  the  input,  file  for  thi  command 
and  the  report  is  produced  usinu  all  the  names  in  the 
file.  when  a sinqle  name  is  specified  by  the  NAME 
parameter,  t h > report  is  nroducod  tor  that  name 
alone.  iitu°r  FILE  or  KANE  can  bo  used  but  not  both. 
Tr.  any  case,  all  t he  names  must  be  data  types  (SETS, 
INPUTS,  OUTPUT; , ENTITIES,  GFOUPE,  ELEMENTS)  or  types 
which  potentially  access  data  t.  yp.-*s  (PnOCLSSFS, 

INTF  T FACLt',  P?l*C  t FSOPA)  . I he  infit  file  format  is 
one  user  name  pox  line.  The  report  will  be  produced 
for  each  niT*  in  t. ho  inpu-  file. 

P.-l  U I - N U L L-  S ECU  1 1 T Y-  T N EO  5 FA  1 TON  (ft  SI) 

"OPr  I NT- XULL  — c;;t*llh'TTY*  T S FOt>  M'l  ION  (N  FNSI ) 

Pefa  tilt:  Ni'Nf. 

It  this  paiametei  is  .'.pec it  t.?d , a list  is  produced  of 
names  in  the  data  base  for  which  security  information 
cou 1 1 be  defined  but  tot  which  security  information 
has  not  been  d.  i i nod  . 

PRINT- MATRIX  (PM  AT)  , NO r F I NT- K ATF IX  (NONA T) 

Del x ul t : PN AT 

It  this  p,n  imr*t  ■>[  is  specified  the  security  conflicts 
matrix  is  printed.  otherwise,  the  matrix  is  not 
printed . 

INDEX,  NOINDEX  Default:  NOINIiX 

The  index  parameter  specifies  the  production  of  an 
index  for  the  Security  Analysis  Report.  This  index 
consists  of  an  alphabetical  listiny  of  all  user-names 
included  in  the  report  and  the  paye  (s)  on  which  they 
occur. 

SECUFITY- ANALYSIS  N AM E = hourly- employee- processing 
SECA  INDEX 
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Command: 


STRUCTURE 


Type:  report  command 


Purpose:  To  produce  a STRUCTURE  report  for  INPUTS,  OUTPUTS, 

PROCESSES,  INTERFACES  or  PROCESSORS. 

Prototype:  STRUCTURE  (STR)  f pa  ~ameter  ].  . . 

Parameters: 


Output- 

Data 


Output- 

Option 


Output- 

Format 


:ndex,  ncindex 


Default:  NOINDEX 


The  INDEX  parameter,  when  given,  specifies  the 
production  of  an  index  to  the  report,  giving  the 
pages  on  which  each  undefined  name  used  in  the  report- 
occurs.  NOINDEX  specifies  that  no  index  should  be 
generated . 


URA  will  produce  structure  reports  for  the  following 
name  types  when  given  as  parameters.  (Only  one  may 
be  given  for  each  report.) 

IN  PUT  (I N P)  Default:  PROCESS 

OUTPUT  (OUT) 

PFOCESS  (PROC) 

INTERFACE(INTF)  ‘ 

PROCESSOR  (PRCR ) 


INDENT  (IND) ^integer 


Default:  INDENTS 


The  number  is  the  number  of  spaces  to  indent  each 
succeeding  level  in  the  report.  INDENT  must  take  on 
some  value  greater  than  o and  less  than  11. 


Examples: 


STRUCTURE 
STR  INPUT 


1 PEAL- WORLD- ENTITY  (R WE)  may  be  used  in  place  of  INTERFACE. 
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SUMMARY  Type:  report  command 

To  produce  the  DATA  BASF  SUMMARY  output. 

SUMMARY  (SUM) 

no  parameters 

SUKMAFY 

SUM 
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1.  INTRO  DUCTION 


Whenever  an  organisation  develops  nn  information  system,  one  ot 
the  malor  problems  is  maintaining  it  over  its  life,  l'ho 
developers:  of  the  system  Ale  rarely  aiound,  or  available  to  help 
the  maintenance  group  in  their  task.  A frequent  result  of  this 
situation  is  a complete  redesign  And  redevelopment  or  the  system 
to  make  relAtively  minor  mod  if  ion  t ions  to  the  system.  Such 
practice  is  An  obvious  wAst e ot  resources  thnt  could  hAve  been 
Avoided  with  proper  document  At  ion . While  the  Above  is  a strong 
motivator  for  the  need  for  document Ation  standards,  there  Are 
other  advantages  involved,  namely,  better  communicAtion  between 
developers  of  the  system.  eAsiet  training  of  new  employees,  etc. 
Hence,  most  organisation?:  hAve  developed  their  own  standards 
which  must  be  Adhered  to  for  documenting  the  system.  Fxamples 
of  such  stAndsrds  Are  MILITAF'Y  standard?:  4H3  And  4,90  And 
Department  ot  Defense  Mamma  1 4120. 1 7- m. 

Much  ot  the  information  thAt  is  needed  in  the  final  document, 
describing  the  system  mAy  be  ohtAinnd  during  the  system's 
aha  lysis,  design,  and  construction  phases  ot  the  development 
life  cycle.  Therefore,  vliAt  is  needed  is  a mechanism  thAt  will 
Allow  the  capture  ot  the  information  as  and  when  it  becomes 
available  and  storing  it  in  a readily  usable  data  base.  This  in 
where  the  UFl/HFA  data  base  comes  into  the  picture. 

The  Automated  Documentation  System  provides  the  means  of  easily 
producing  a document  according  to  a specific  standaid.  The 
process  of  creating  the  document  is  a three  step  procedure.  A 
table  of  contents  or  structured  outline  for  the  desired  document 
must  he  completed.  This  information  must  be  stated  in  a 
prescribed  format  (see  Section  1).  Thin  part  of  the  process  in 
referred  to  as  the  creation  ot  the  documentation  schema.  The 
Analyser  data  base  is  used  to  store  and  easily  keep  current  the 
information  about  the  system  being  documented.  The  Analyser 
data  base  is  created  by  an  analyst  or  documentor  who  is 
concernel  with  capturing  an  up-to-date  and  complete  description 
of  the  system,  There  in  no  ordering  to  these  steps.  The 
analyst  or  documentor  must  insure  that  all  information  required 
by  the  documentation  .standard  is  in  the  Analyzer  data  base.  The 
third  part  of  the  documentation  procedure  is  to  describe  the 
document  body  in  a prescribed  format  (see  Section  2).  The 
process  is  referred  to  as  the  creation  of  the  documentation 
source.  Consistency  and  coordination  between  the  documentation 
schema,  documentation  source  and  Analyser  data  base  is  required 
to  automatically  generate  a good  document. 

The  three  components  of  the  Automatic  Documentation  System  are 
the  documentation  schema,  the  documentation  source  anu  the 
Analyter,  These  components  are  discussed  in  this  Dart  of  the 
Manual.  To  clarify  the  usage  of  these  terms  and  other  term?:  in 
this  Dart  of  the  Manual,  a glossary  is  included. 
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2.  DOCUMENT  INITIALIZATION 


The  initialization  for  the  Allocated  Documentat ion  System  must 
be  performed  for  each  project  to  be  documented.  This  task  aay 
be  perforaed  by  the  project  leader.  It  involves  taking  the 
Military  Standard  and  deriving  froa  thea  relevant  headings  for 
the  particular  project  in  aind.  For  this  paper  Military 
Standard  4120. 17-K  will  be  used  as  the  basis  (teaplate)  for  the 
generation  of  the  docuaent.  Portions  of  this  docuaent  ate  shown 
in  the  example  of  Appendix  B.  The  initialization  allows  the 
project  director  to  identify  the  an jor  and  detailed  areas  of 
docuaentation  to  be  produced  by  the  project  teaa  members.  It 
can  be  most  succinctly  expressed  as  the  *-ahle  of  contents  to  bo 
shown  in  the  final  docuaentation.  Uence,  the  documentation 
schema  is  equivalent  to  a listing  of  the  entries  in  the  table  o: 
contents  or  structured  outline  of  the  desired  docuaent.  The 
details  of  the  schema  syntax  will  be  discussed  in  Section  1,?. 
Development  of  a documentation  schema  is  discussed  in  Section 
4.1.  Soction  1.1  will  discuss  some  ot  the  strategy  to  be 
followed,  and  the  general  initialization  process.  The  end 
result  of  the  initialization  process  is  a documentation  object 
scheaa. 


2.1  Tk  JBficuSSUiaiifl!!  Z flJLaiSSI  Ifil  i^e  Uacuaent. 

liiiililimlan 

There  are  basically  four  types  of  entries  that  may  be  enteied 
into  the  documentation  schema.  Any  entry  line  is  a maximum  ot 
flO  characters.  The  entries  aay  be  typed  in  on  cards,  or  other 
media;  in  this  fora  they  are  known  as  the  documentation  source 
schema.  when  these  same  entries  have  been  entered  into  a Tile 
on  the  target  computer  which  alsc  has  the  Analyzer  data  base, 
the  entries  are  known  as  the  documentation  object  schema.  The 
process  of  converting  the  source  scheaa  into  the  object  schema 
would  generally  involve  nothing  more  than  reading  in  the  cards, 
etc.,  into  a file.  The  source  schema  is  external  to  the 
computer  while  the  object  schema  is  stored  in  a file.  One  ot 
the  most  common  ways  of  doing  this  is  by  a local  text  editor,  or 
some  other  file  populating  mechanism.  This  processor  (editor, 
etc.)  is  known  as  the  documentation  initializer  (Figure  77). 

The  four  types  of  entries  that  mav  be  entered  into  the 
docuaentation  schema  are: 

- the  table  of  contents  (SECTION  FNTFIES) 

- formatting  commands  (TEXT  FORMATTING  LNTPIFF) 

- comments  (COMMFNT* ENTRIES) 

- host  formatting  commands  (HOST-FOFMATTING-ENTFIFS) 

The  table  of  contents  entries  are  all  preceded  by  a 
distinguishing  character,  which  must  be  entered  on  eveiy 

heading  to  appear  in  the  table  of  contents.  Formatting  commands 
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ate  proceeded  by  the  d ist inguishi ng  character  "*H.  Any 
formatting  command  will  be  executed  directly  before  the  next 
section  header  is  printed  in  the  document  (this  character ist ic 
will  be  discussed  in  section  4.1). 

The  manager  ^ay  want  to  insert  into  the  documentation  scheia, 
personal  comments  which  ate  not  to  appear  in  the  final  table  of 
contents.  These  may  be  specified  by  a "f,H  followed  by  a comment 
of  up  to  79  characters.  Should  the  comment  be  lonqer,  it  may  be 
continued  on  the  next  lint*  but  preceded  by  another  "f.". 

Comments  may  be  used  to  quide  the  documentors,  to  assign 
specific  portions  of  the  documentation  to  particular 
individuals,  etc. 

The  formatting  command  of  the  host  installation  text  formatting 
facility  may  be  included  in  the  schema.  However  caution  should 
be  taken  to  set  the  *FOFMAT  command  properly  (refer  to  section 
4. 2. 4.1  for  detailed  description).  In  any  case,  the  host 
formatting  commands  are  not  processed  by  the  Automated 
Documentation  System. 

A line  starting  with  "t"  in  column  1 is  interpreted  by  the 
Automated  Documentation  System  as  an  Analyzer  command.  If  such 
a line  is  found  in  the  schema,  it  will  be  ignored  and  a warning 
message  to  this  effect  will  be  given. 

Although  a rare  situation,  it  mav  be  necessary  on  some 
installations  to  have  different  distinguishing  characters  to 
indicate  a special  line  to  the  Automated  Documentation  System. 
For  example,  Multics  installations  must  use  the  character 

instead  of  the  character.  This  is  the  only  installation 

that  must  use  this  convention. 


1 


1 


' 
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2. 2 Syntax  for  the  Documentation  Schema 

SECTION-ENTPILS  have  the  following  syntax: 

• SECTION- I DENT I FIEF  f HEADING- ENTRY  ] 

The  section- identif ier  must  he  preceded  by  a "#"  in  column  1. 

The  section- identif ier  is  the  unique  string  corresponding  to 
that  section  of  the  documentation  schema  (e.g.,  2.2.3).  This 
string  may  he  made  up  of  numbers,  characters  and/or  special 
characters.  No  particular  restrictions  are  placed  on  the  format 
of  the  identifier  (except  tor  those  placed  or  by  a specific 
installation's  control  characters);  for  example,  an  identifier 
of  1.2s.l.b  is  a perfectly  legitimate  identifier.  The  section 
entry  may  not  exceed  HO  characters.  It  is  important  to  note 
that  there  must  be  at  least  one  space  between  the  identifer  and 
the  heading  entry.  The  final  documentation  will  be  produced  in 
the  order  that  the  identifiers  were  entered  in  the  documentation 
schema.  Hence,  it  is  the  responsiblity  of  the  individual 
preparing  the  documentation  schema  to  enter  them  in  the  proper 
order.  The  documentation  generator  will  not  check  to  see  that 
these  entries  are  sorted.  The  heading-entry  is  the  title  to  be 
given  to  the  section.  This  is  the  title  that  will  appear  in  the 
final  document. 

TEXT-FORMATTING-ENTFIES  have  the  following  syntax: 

♦CONTROL- IN FORMATION- ENTRY 

The  text  formatting  commands  mav  also  be  interspersed  anywhere 
in  the  schema  but  must  be  preceded  by  a in  column  1.  A 

detailed  description  of  the  formatting  commands  is  given  in 
section  4.2.4. 1. 

COM ME NT- E NT FI ES  have  the  following  syntax: 

6 COMMENT 

Comments  may  be  interspersed  anywhere  in  the  documentation 
schema.  They  will  not  appear  in  the  final  output.  The  "6"  must 
appear  in  column  1.  The  comment  on  a given  line  can  be  a 
maximum  of  79  characters. 

HO ST- FORMATTING- ENTRIES: 

If  the  final  document  is  to  be  produced  by  the  host  installation 
formatting  facility,  the  host  formatting  facility  commands 
should  be  included  wherever  necessary.  It  is  recommended  in 
this  situation  that  the  formatting  command  *FOFMAT  IGNOFED  (See 
section  4. 2. 4.1)  be  specified  as  the  first  line  in  the  schema. 
There  is  no  limit  to  the  number  of  comment  entries,  header 
entries,  and  formatting  entries  in  a documentation  source 
schema.  An  example  of  a documentation  source  schema  is: 
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#2.  PHOJECT  DEVELOPMENT  EN VI PONM ENT/ DOC UK ENT AT ION  SYSTEM 
• 2.1  DSVF.LOPKENTAL  PHASES 
•2.1.1  INITIATION 

STHEFE  SHOULD  BE  NO  NEED  TO  HAVE  ANY  OTHEP  LISTS  POP  US. 
(A  larger  example  is  in  Appendix  F.) 
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3.  DOCUMENTATION  SOURCE  POPULATION 


The  actual  documentation  to  he  written  would  probably  be  done  by 
■ore  than  one  individual.  These  individuals  «ay  enter  the 
documentation  of  the  areas  they  are  responsible  for,  into 
different  files,  or  into  one  comon  file  assigned  to  be  shared 
by  them.  In  the  former  case,  the  documentation  manager  must 
merge  the  different  pieces  of  the  documentation  into  a single 
file.  The  order  of  this  file  is  not  important,  as  the  final 
documentation  will  be  produced  in  the  order  specified  by  the 
documentation  schema  (see  Section  1) . The  input  for  the 
documentation  source  is  referred  to  as  the  documentation  source 
input. 


The 

documen 

tation  source 

contains  the 

inf  or 

ma 

ticn 

on  the 

cont 

ents 

of 

the 

document 

body.  This  i 

nf  ora 

a t 

ion 
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vari 

ous 

typ 

es  of 

entries . 

There  are  s 

ix  en 

tr 

y ty 

pes: 

Sect 
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ries. 

analyzer 

-comraand-entr 

ies, 

text 

-f  or 

■ at 

ting- 

entries. 

host-formatti 

ng-en 

tr 

ies. 

comm 

ent- 

ent 

ries. 

and  text 

entries. 

3. 1 strategy  for  the  Documentation  Source  Population 

It  is  important  that  the  individuals  who  are  going  to  document 
the  system  know  what  is  in  the  Analyzer  data  base.  They  should 
be  given  a complete  NAME-LIST*  or  NAME-GEN  * of  names  in  the 
Analyzer  data  base.  They  should  have  a 

FOPMATTED-PROBLEM-STATEHENT*  of  all  these  names,  or  have  access 
via  a terminal,  to  the  Analyzer  data  base  to  query  the 
information  within  it.  For  example,  it  the  documentation  calls 
for  the  description  of  a particular  input,  say  TEST-RESULTS, 
this  should  be  in  the  Analyzer  data  base,  and  the  documentor 
should  be  required  to  invoke  its  description  from  the  Analyzer 
data  base  rather  than  to  have  to  retype  it.  This  has  two 
obvious  advantages:  the  one  mentioned  above  (reduction  of 
redundant  work),  and  the  other  one  of  always  having  an 
up-to-date  description  of  the  item  of  interest.  It  is  the  duty 
of  the  project  manaqer  to  see  that  all  Analyzer  entries  have 
been  made,  and  do  exist.  The  above  also  implies  that  the 
documentor  be  quite  familiar  with  the  use  of  the  Analyzer. 

The  individuals  populating  the  documentation  source  must  also 
have  access  to  or  a copy  of  the  documentation  schema,  and  must 
use  the  same  section-identifiers  as  used  in  the  schema.  It  is 
also  feasible  to  have  a limited  amount  of  text  formatting 
capability  such  as  getting  to  the  top  of  the  next  page,  or 
skipping  to  next  half  page,  etc.  This  capability  would  be  used 


* Part  IV,  "User  Requirements  Analyzer  Command  Descriptions"  and 
Part  III,  "UFA  Outputs"  for  an  explanation  of  these  commands  and 
corresponding  outputs. 
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xhote  a diagram,  or  table  which  coulii  not  he  drawn  hy  the 
doouaentati on  generator  had  to  be  inserted,  and  space  ha  1 to  be 
left  for  it.  An  entry  line  for  the  docuaion  ta  t ion  source  is  a 
aaxiaua  of  120  characters. 

To  distinguish  between  the  various  kinds  of  entries  in  the 
docuaentation  source,  section  entries  are  preceded  by  a "t"  in 
coluan  1,  Analyzer  coaaand  entries  are  preceded  by  a in 

coluan  1,  text-foraattinq  entries  are  preceded  by  a in 

coluan  1,  and  the  actual  text  itself  has  nothing  preceding  it, 
and  aay  begin  in  coluan  1.  If  host-formatting  entries  are  being 
used,  the  proper  syntax  of  the  particular  foraattinq  processor 
should  be  applied.  Preceding  blanks  are  considered  part  of  the 
text.  An  entry  line  for  the  docuaenta t ion  source  is  a aaxiaum 
of  120  characters.  Text  entries  have  no  specific  foraat. 

The  docuaentation  source  aay  be  populated  by  the  docuaentors  in 
auch  the  saae  way  as  the  docuaentation  scheaa  (Figure  78),  i.e., 
any  processor  such  as  the  text  editor,  file  populator,  etc.,  iray 
be  used  to  store  the  source  in  the  docuaentation  data  base  which 
aust  be  a file.  If  several  docuaentors  are  working 
simultaneously,  different  files  aay  be  assigned  *o  individual 
docuaentors.  These  portions  of  the  docuaentation  data  base  cur 
then  be  aerged  at  docuaentation  generation  tiae.  The  order  ot 
the  section  entries  is  uniapottant. 


3.2  SMi&i  l2£  ib£  Soui£e 

StCTION-SNTFINS  have  the  following  syntax: 

• SECTION-  IDENTIFTFP  [ HEADING- CO f KENT  ] 

The  section  entries  are  the  sane  as  in  the  docuaentation  schema. 
However,  the  text  portion  (heading-coaaent)  in  the  docuaentation 
source  is  ignored.  Only  the  section-identifier  is  used  to  match 
against  the  documentation  schema.  The  " aust  be  in  coluan  1. 

ANALYZEF-COHMAND-ENTFIES  have  the  following  syntax: 

tANALYZF.F-COMMANC 


Analyzer  coaaands  may  be  interspersed  anywhere  in  the  source 
with  the  provision  that  thoy  be  preceded  by  a "V  in  column  1. 


Any  Analyzer  commands  from  Part  TV*  are  allowed  except  the  STOP 
coaaand  and  the  SET  coaaand  with  the  parameter  PFOMPT=ON  (by 
default,  this  is  not  in  effect).  The  Analyzer  coaaands  are  not 
executed  immediately  . They  are  just  stored  as  is  until  the 
docuaentation  generation  process. 

TEXT-FORM ATTI NG- ENTRIES  have  the  following  syntax: 

1 Part  IV,  "User  Feauirements  Analyzer  Command  Description." 
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♦CONTEOL-IN’FOFMATION-ENT&r 

The  same  text  formatting  commands  available  for  use  in  the 
schema  are  also  available  tor  use  in  the  source.  These  commands 
are  explained  in  Section  4.2.4. 1.  They  may  be  interspersed 
anywhere  in  the  documentation  source.  The  "*  " must  be  in  column 

1. 

CONMENT-ENTIFFS  have  the  iollovirui  syntax: 

ECOKMFNT 

Comments  may  be  intersoersed  anywhere  in  the  documentation 
source.  They  will  not' appear  in  the  final  output.  The  "6"  must 
be  in  column  1. 

HOST- FORM  ATTINC-ENTHF S: 

It  used,  the  host  formatting  facility  entries  should  follow  the 
syntax  of  the  particular  processor  and  may  appear  anywhere  ir 
the  documentation  source.  The  Automated  Documentation  System 
text  formatting  commands  should  not  be  used  when  utilizing 
another  text  formatting  facility  unless  the  ‘FORMAT  IGNORE 
command  has  been  given. 
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4.  THE  DOCUMENTATION  t’  N S F A T 1 0 N 


Th<  docuraen tat  ion  gone  ra  t i on  may  be  per  for  Me  J by  the  project 
manager  when  ono  wishes  to  have  the  completed  documentation. 

The  Manager  may  first  wish  to  ascertain  that  the  docuaontat ion 
is  indeed  complete.  It  is  possible  for  the  manaqer  to  find  this 
out.  However,  the  extent  of  checking  is  limited  to  the  absence, 
or  presence  ot  an  entry  in  the  documentation  data  base 
corresponding  to  every  entry  in  the  schema.  There  is  no  check 
to  find  out  if  the  corresponding  data  Jnase  entries  also 

exist. 

It  the  project  manager  finds  that  all  entries  in  the  schesa  have 
corresponding  entries  in  the  source,  one  cai.  now  go  ahead  and 
initiate  the  generator  to  produce  ♦he  tinal  documentation  as  per 
the  speci f i cat  ion  in  the  documentation  schema.  The  manager  must 
realize  tha*  this  will  be  a lengthlv  process,  as  it  involves  the 
invocation  ot  analyzer  commands,  the  generation  of  intermediate 
files,  and  »he  merging  ot  several  files  to  produce  the  final 
documentation  (Figure  1Q).  Hence,  it  is  recommended  that  this 
be  done  in  batch  mode.  Because  the  Analyzer  processor  is  being 
run  when  the  documentation  is  desired,  it  will  he  using  the 
latest  version  of  the  system  description. 

The  process  that  the  Documen ta : ion  Generator  goes  through  is 
shown  in  Figure  7q.  i*  involves  two  steps.  Phase  I (CHECK) 
checks  to  see  what  Section  Entries  in  the  schema  are  present  in 
the  documentation  source.  It  also  extracts  all  Analyzer 
commands  from  the  source  and  writes  them  into  a separate  file  to 
be  used  as  input  to  the  Analyzer.  Phase  II  (UFA)  executes  the 
Analyzer  usinq  each  command  in  the  documentation  source.  Phase 
III  (MEFGF)  merges  the  output  from  the  Analyzer  with  the 
documentation  source  and  produces  the  document.  It  is  at  this 
point  that  the  text- formatt  ir.g  commands  are  processed.  The 
documentation  may  be  further  processed  by  the  text  formatting 
facility  of  the  host  installation  to  produce  the  final  document. 
Phase  IV  is  optional. 

The  procedure  for  documentation  generation  is  dependent  on  the 
operating  system  under  which  the  Automated  Docu ment at i on  System 
is  installed.  Hence,  there  is  no  on*  standard  way  to  invoke  the 
Automated  Documentation  System.  Appendix  H will  include  the 
system  dependent  information  required  to  execute  the  Automated 
Documentation  System  and  generate  a document. 
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5.  USAGE  OF  1 HE  DOCUMENTATION  GENFFATOF 


In  usinq  the  documentation  generator,  there  are  several  areas 
that  need  to  be  considered  in  order  to  achieve  a desired  quality 
level.  Coordination  between  the  schema,  documentation  data 
source  base,  and  the  Analyzer  data  hase  are  mandatory  in  order 
to  develop  a document  which  will  contain  complete  information. 
Development  of  the  methods  to  produced  these  three  inputs  into 
the  system  so  that  they  can  be  used  in  an  onqoinq  operation 
(camera-ready  documentation)  is  the  topic  of  this  section. 
Considerations  as  to  what  should  he  included  in  each  component, 
what  pitfalls  should  be  watched  out  for,  and  what  variations 
miqht  arise  in  usage  of  the  documentation  generator  will  be 
discussed.  It  is  important  for  the  reader  to  realize  at  this 
point  that  while  this  system  has  been  developed  to  provide  a 
generalized  format  for  producing  documents  under  a set  of 
standards,  the  system  still  allows  a great  deal  of  flexibility 
to  the  user. 

Department  of  Defense  Manual  4120. 17-m  along  with  MIL  Standard 
483  will  be  used  as  example  documentation  standards  in  this 
discussion.  Development  of  a Functional  Description  and  Data 
Requirements  Document  of  the  Pay  System  Analyzer  data  base  (W.P. 
74)  » will  be  used  as  a specific  example  (Appendix  F)  . 


5. 1 development  of  the  Documentat ion  Schema 

The  documentation  schema  consists  of  a structural  outline  or 
table  of  contents  of  the  particular  document  being  produced. 

From  this  schema  a table  of  contents  tor  the  document  being 
generated  will  be  produced.  Hence,  it  is  important  that  the 
user  include  enough  section  levels  in  order  to  make  the  table  of 
contents  meaningful.  It  is  also  important  to  note  that  the 
final  documentation  will  be  produced  in  the  order  stated  in  the 
documentation  schema,  so  the  schema  should  he  set  up 
appropriately. 

The  format  and  syntax  for  the  schema  is  discussed  in  Section  1. 
The  documentation  initializer  produces  the  documentation  and 
schema  which  is  stored  permanently  on  rile  after  any  required 
editinq  is  done. 

Within  the  schema,  comments  and  formatting  commands  are  allowed. 
The  schema  is  checked  to  see  if  it  contains  any  formatting 
commands.  If  it  does,  each  formatting  command  goes  into  effect 
prior  to  the  printing  of  the  next  section  header  and  immediately 
following  the  formatting  command,  provided  that  *FORMAT  ON  is  in 
effect.  This  is  also  true  for  commands  at  the  beginning  of  the 
schema. 


» "An  Example  of  the  Use  of  PSL  Using  Top-Down  Analysis." 
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Although  it  is  suggested  that  the  table  of  contents  of  a 
particular  document  or  standard  bn  used  as  the  schema,  many 
times  a more  detailed  schema  is  warranted.  Situations  whet<’ 
more  or  less  detail  might  be  deemed  necessary  are  in  the 
following  subsections. 


5.1.1  hiisls  laaE  mail  flidlii  is  im&iail 

The  table  of  contents  of  a certain  standard  is  a skeleton  typo 
set  up,  giving  suggest ions  on  how  the  documents  should  be 
developed,  but  leaving  room  for  variances  in  structure  from  one 
document  to  another  written  according  to  the  standard.  In  thi.. 
cas->  it  might  be  wise  to  use  less  detail  in  the  schema  and  keep 
it  as  general  as  possible. 

An  example  of  this  situation  arises  in  MIL  standard  Mil,  in 
Section  3.2  of  the  desired  document,  the  standard  sets  up  the 
criteria  for  describihg  each  separate  junction  of  a system. 

Since  there  is  going  to  be  a varying  number  of  functions  in 
different  systems,  the  standard  sets  up  the  description  as 
fol lows: 

3.2. X  Function  X 

3.2. X. 1 INPUT? 

3. 2. X. 2 PROCESSING 

3. 2. X. 3 OUTPUTS 

Thus,  this  basic  structure  is  repeated  fci  oveiy  function  in  the 
system.  This  causes  a definite  problem  when  using  the  document 
generator.  Since  it  Is  desirable  to  have  one  schema  for  all 
documents  produced,  it  can  be  seen  that  since  the  number  of 
functions  will  vary  from  one  system  to  the  next,  the  standard's 
table  of  contents  cannot  be  followed  strictly. 

Throe  options  are  open  to  the  documentor  in  cases  like  this. 

a)  Include  in  the  schema  only  the  section  headet  (ti.2 

PSTAILED  FUNCTIONAL  M'OUIFFNFNT?)  and  leave  the  rest  to  be 
described  in  the  source.  Comment  entries  could  bo  included 
in  the  schema  to  describe  what  should  be  included  with 
these.  The  advantage  of  this  option  is  that  the  schema 
will  be  constant  and  independent  of  each  instance  of  this 
document.  The  disadvantage  is  that,  the  schema  will  now 
lack  information  and  the  table  of  contents  will  tie  somewhat 
incomplete. 

• 3.2  DETAILED  FUNC".  ION  FEQUIFEMKNTS 
R PARAGRAPH  3.2X  FUNCTION  X. 

R THE  PA?  IC  PAFAGFATH  FOF  FACIi  FUNCTION  SHALL  HEG1N  WITH 

R DESCRIPTIVE  AND  lNTPOTUCTOFY  MATERIAL  WHICH  DEFINE? 

R THE  FUNCTION  AND  IT?  F L l A’r  ION  SHI  F TO  OTHER  FUNCTION?. 

R THEN , THE  FOLLOWING  THFXF  SUP  PARA  GRAPH?  SIIALl  SPFCTFY 


R THF  QUALITATIVE  F LQUTR!'MFNTS  CONCERNING  THE  FUNCTION. 
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e PAR  ACiF  APtl  3 . 2 . X . 1 INPUTS, 
fi  PARAGRAPH  3.2.X. 2 PROCESSING. 

F.  PAPAGFAPfl  3.2.X. 3 OUTPUTS. 

b)  Set  up  the  schema  for  an  arbitrary  number  of  functions.  An 
example  of  this  would  be: 

#3.2.1  FUNCTION  ONI. 

13.2.1.1  INPUTS 

13.2.1.2  PROCESSING 

13.2.1.3  OUTPUTS 

#3.2.2  FUNCTION  ONE 

•3. 2. 2.1  INPUTS 

#3. 2. 2. 2 PROCESSING 
•3. 2.2. 3 OUTPUTS 


• 

#3.2.12  FUNCTION  TWELVE 

#3.2.12.1  INPUTS 

#3.2.12.2  PROCESSING 

#3.2.12.3  OUTPUTS 

The  advantage  of  this  option  is  that  the  table  of  contents 
is  complete.  The  disadvantage  is  that  the  entries  in  the 
table  are  not  meaningful. 

c)  Include  in  the  schema  the  actual  function  names  for  each 
system.  An  example  of  this  would  be: 

*3.2  DETAILED  FUNCTION  REOUI REMFNTS 

•3.2.1  SENSOR  CALIBRATION  (INITIAL)  FUNCTION 

#3.2.1. 1 INPUTS 

#3. 2. 1.2  PROCESSING 

#3. 2. 1.3  OUTPUTS 

#3.2.2  ELEMENT  CORRECTION  (INITIAL)  FUNCTION 

#3.2. 2.1  INPUTS 

#3. 2. 2. 2 PROCESSING 

*3. 2. 2. 3 OUTPUTS 

#3.2.3  MANEUVER  DETERMINATION  CONTROL  FUNCTION 

#3.2.3. 1 INPUTS 

•3. 2.3. 2 PROCESSING 

#3.2.3. 3 OUTPUTS 

•3.2.4  SIMULTANEOUS  SOLUTION  OF  MANEUVER  AND  ELEMFNT 

FUNCTIONS 

• 3.2.4. 1 INPUTS 

*3. 2. 4. 2 PROCESSING 

#3. 2. 4. 3 OUTPUTS 

#3.2.5  ELEMENT  MAINTENANCE  CONTROL  FUNCTION 

#3. 2. 5.1  INPUTS 

#3. 2. 5. 2 PROCESSING 

#3. 2. 5. 3 OUTPUTS 

#3.2.6  ELEMENT  CORRECTION  (ROUTINE)  FUNCTION 

• 3.2.6. 1 INPUTS 
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•3. 2.6. 2 

PROCESSING 

j 

*3.2.6. 3 

OUTPUTS 

M 

*3.2.7 

OBSERVATION  EDITING  FUNCTION 

j] 

*3.2.7. 1 

INPUTS 

*3. 2. 7. 2 

PROCESSING 

*3.2.7. 3 

OUTPUTS 

*3.2.8 

SENSOR  CALIBRATION  (ROUTINE)  FUNCTION 

*3.2.8.  1 

INPUTS 

*3.2.8. 2 

PROCESSING 

•3.2.8. 3 

OUTPUTS 

f' 

• 3.2.9 

ELEMENT  PECOVEFY  CONTROL  FUNCTION 

•3.2.9. 1 

INPUTS 

*3. 2. 9. 2 

PROCESSING 

*3.2.9. 3 

OUTPUTS 

*3.2.10 

ELEMENT  COFRECTION  (PECOVEFY)  FUNCTION 

*3. 2.1G.1 

INPUTS 

•3.2.10.2 

PROCESSING 

*3.2.10.3 

OUTPUTS 

*3.2.11 

MANFUVER  DETECTION  FUNCTION 

*3.2.11.1 

INPUTS 

*3.2.11.2 

PROCESSING 

*3.2.11.3 

OUTPUTS 

*3.2.12 

MANUAL  INTERACTIVE  DIFERRENTI AL  CORRECTION 

FUNCTION 

*3.2.12.1 

INPUTS 

*3.2.12.2 

PROCESSING 

*3.2. 12.  3 

OUTPUTS 

The  Advantage  of  this  method  is  that  the  schema  is  complete 
and  dascriptive.  The  disadvantage  is  that  the  schema  will 

have  to  be 

changed  for  each  application  document. 

The  decision  as  to  which  one  of  these  options  should  be 

used  is  up 

to  the  discretion  of  the  user. 

5.1.2  where  Wore  Detail  Miaht  pe  Necessary 

If  within  the  standard,  references  are  Bade  to  information  that 
is  deemed  necessary  to  include  within  a certain  section,  it 

1 

might  be  advisable  to  include  this  information  in  the  schema. 

An  example  of  this  would  be  in  the  Data  Requirements  Document  of 

D.O.D.  Manual 

412V17-M.  In  this  document,  the  table  of 

contents  looks 

as  follows: 

- 

1.  GENERAL  DATA  REQUIREMENTS 

1.  1 PURPOSE  OF 

DATA  REQUIREMENTS 

1.2  PROJECT  REFERENCES 

1.3  MODIFICATION  OF  DATA  F EQtll  F FMENTS 

2.  DATA  DESCRIPTION 

2.1  LOGICAL  ORGANIZATION  OF  STATIC  SYSTEM  DATA 

2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

2. 4 INTERNALLY 

GENERATED  DATA 
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2.5  SYSTEM  DATA  CONSTRAINTS 
3.  USER  SUPPORT  FOR  DATA  COLLECTION 

3.1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 

3.2  FECOMMEND  SOURCE  OF  INPUT  DA't# 

3.3  DATA  COLLECTION  AND  TFANSFFR  PROCEDURES 

3.4  DATA  SAFE  IMPACTS 


within  Section  3.1,  the  standard  refers  to  nine  areas  of 
supplementary  information.  If  this  information  is  considered  to 
be  of  such  a nature  that  it  will  or  should  be  included  in  most 
all  the  documents  being  produced,  the  user  might  want  to  include 
the  information  in  the  schema  (therefore  in  ♦•he  table  of 
contents  of  the  document).  The  schema  would  then  look  like: 

#1.  GENERAL  DATA  REQUIREMENTS 

*1.1  PURPOSE  OF  DATA  REQUIREMENTS 

#1.2  PROJECT  REFERENCES 

#1.3  MODIFICATION  OF  DATA  REQUIREMENTS 

#2.  DATA  DESCRIPTION 

#2.1  LOGICAL  ORGANIZATION  OF  STATIC  SYSTEM  DATA 

#2.2  tOGICAl  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

#2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

#2.4  INTERNALLY  GENERATED  DA^A 

#2.5  SYSTEM  DATA  CONSTRAINTS 

#3.  USER  StTPPOFT  FOR  DATA  COLLECTIONS 

#3.1  TATA  COLLECTION  REQUIREMENTS  AND  SCOPE 

*3.1.1  INPUT  SOURCE (S)  OF  THE  DATA  ELEMENT 

#3. 1. 2 INPUT  MEDIUM 

#3.1.3  RECIPIENTS 

#3.1.4  CRITICAL  VALUE 

#3.1.5  SCALES  OF  MEASUREMENT 

#3.1.6  CONVERSION  FACTORS 

#3.1.7  OUTPUT  FORM/DEVICF 

#3.1.8  EXPANSION  FACTORS 

#3.1.9  FREQUENCY  OF  UPDATE 

#3.2  RECOMMEND  SOURCE  OF  INPUT  DATA 

#3.3  TATA  COLLECTION  AND  TRANSFER  PROCEDURES 

*3.4  DATA  RASE  IMPACTS 

It  might  be  that  the  documentor  lust  needs  to  be  reminded  of  the 
supplementary  information.  In  this  case  it  miqht  be  appropriate 
just  to  include  an  appropriate  comment. 

#1.  GENERAL  DATA  REQUIREMENTS 
#1.1  PURPOSE  OF  DATA  REQUIREMENTS 
#1.2  PROJECT  REFERENCES 
• 1.3  MODIFICATION  OF  DATA  F EQUI REMFN1 S 
#2  DATA  DESCRIPTION 

#2.1  LOGICAL  ORGANIZATION  OF  STATIC  SYSTEM  DATA 

#2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

#2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

#2.4  INTERNALLY  GENERATED  DATA 

*2.5  SYSTEM  DATA  CONST  t A I NT  S 

#3.  USE.F  SUPPORT  FOR  TATA  COLLFCTION 
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#3.1 

DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 

fi 

AT 

THIS  POINT  IT  SHOULD  BE  NOTICED  THAT  THERE  A R F 

NINE 

AREAS  TO  BE  CONCERNED  WITH  IN  THIS  SECTION.  THEY 

APE: 

A. 

INPUT  SOURCE  (F)  OF  TH  F DA" A ELEMENT 

6 

B. 

INPUT  MEDIUM 

6 

C. 

RECIPIENTS  * 

I 

r. 

D. 

CRITICAL  VALUE 

9 

I 

E. 

SCALES  OF  MEASUREMENT 

6 

F. 

CONVERSION  FACTORS 

6 

0. 

OUTPUT  F0PM/DEV1CE 

e 

tl. 

EXPANSION  FACTOFS 

6 I.  FREQUENCY  OF  UPDATE 

#3.2  RECOMMEND  SOUFCE  OF  INPUT  DATA 

#3.3  DATA  COLLECTION  AND  TRANSFER  FROCFCUFFS 

#3.4  DATA  BASE  IMPACTS 

The  decision  as  to  what  should  he  in  the  schema  is  based 
primarily  on  how  much  detail  is  wanted  and/or  expected  in  the 
table  of  contents. 


S.  2 Development  of  the  Documentation  Source 

The  required  format  of  *-he  documentation  source  input  and  a 
description  of  how  it  is  transformed  into  the  documentation 
source  is  in  Section  2.  There  are  several  areas  that  the  user 
need  be  aware  of  when  developing  the  documentation  source. 
Proficiency  in  these  areas  is  necessary  if  the  documentor  is  to 
attain  full  range  capabilities  of  the  document  generator. 


5.2.1  Knowledge  of  the  ftnalyzer  Data  Base 


It  is  of  utmost  importa 
knowledge  of  the  inform 
as  the  Analyzer  command 
to  pick  out  the  informa 
known  that  a system  wil 
standard,  it  is  also  ia 
Analyzer  data  base  have 
is  needed  to  fulfill  th 
Since  the  standard  usua 
the  system,  writing  the 
mind  will  usually  serve 


nee  that  the  documentor  have  a thorough 
ation  in  the  Analyzer  data  base  as  well 
language.  The  documentor  must  be  able 
tion  needed  for  the  document.  when  it  is 
1 have  to  be  documented  using  a certain 
portant  that  the  person  developing  the 
a full  understanding  of  what  information 
e standard’s  documentation  requirements, 
lly  requires  complete  information  about 
Analyzer  data  base  with  the  standard  in 
to  insure  a complete  system  description. 


5.2.2  t Material 

The  documentation  source  for  various  projects  written  under  a 
certain  standard  should  be  developed  in  such  a way  as  to 
minimize  the  differences  in  the  various  Documentation  sources. 
This  can  cut  down  substantially  on  the  documentor's  time  spent 
on  each  system.  Another  advantage  of  doing  this  is  that  once  a 
certain  combination  of  commands  has  been  determined  as  the  best 
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way  to  convey  certain  information  required  by  a particular 
standard,  then  that  combination  can  be  repetitively  used  for  all 
projects  documented  under  this  particular  standard. 

Kith  this  in  mind,  the  documentor  should  try  to  include  in  the 
source  only  such  text  that  will  he  present  in  every  instance  of 
the  document  being  produced.  Examples  of  such  text  are  in 
paragraphs  found  in  both  the  Functional  Description  and  Data 
Requirements  Documents.  These  paragraphs  describe  the  purpose 
of  each  of  the  documents: 

Section  1.1 

This  Functional  Description  for  (Project  Name)  (Project 
Number)  is  written  to  provide: 

a)  The  system  requirements  tc  be  satisfied  which  will 

serve  as  a basis  for  mutual  understanding  between 
the  user  and  the  developer. 

b)  Information  on  performance  requirements,  preliminary 

design,  and  user  impacts,  including  fixed  and 
continuing  costs. 

c)  A basis  for  the  development  of  system  tests. 


Section  1.2 


The  objectives  of  this  Data  Requirements  Document  for 
(Project  Name)  (Prolect  Number)  are  to  list  and  define  data 
elements  which  the  system  must  handle  and  to  communicate 
data  collection  requirements  to  the  user. 

Another  examples  of  where  text  should  be  used  is  when  a common 
portion  of  the  document  is  being  described.  An  example  of  this 
is  Section  3.3  of  the  Functional  Description.  Here  is  an 
example  of  how  the  source  might  look: 

#3. 3 INPUTS/OUTPUTS 
INPUTS: 

*NG  S='INPUT' 

*FPS 
♦SKIP  2 

OUTPUTS: 

*NG  S * 'OUTPUT  OP  INPUI' 

*FPS 

%STR  OUTPUT 


Since  the  documentation  source  data  base  will  be  different  for 


each  project  documented, 
constant.  However,  this 
done  by  the  documentor. 


it 

pr 


is  not  necessary  that  the  text  be 
actice  reduces  redundancy  in  work 


Part  V Automated  Documentation  System  User's  Manual 


UFA  User • s Manual 


486 


5.2.3  amIxisi  ^2i2Aiidi 

As  Mentioned  before,  the  documentor  must  have  a full 
understandinq  ot  the  Analyser  command  capabilities  (described 
Part  IV*)  including  all  possible  options.  Thus  knowledge  is 
essential  for  the  document  generator  to  produce  complete 
information  in  a readable  for*.  Some  of  the  commands  and 
options  tha*  Might  be  useful  are  listed  below: 


PCOM 


Options : 


DESCFIP^ION 

NOPUNCH 


Opt  ions : 


NOPFINT, PS  IN? 

KEY  *ke  yword-name 
S* 

TIC,NTLC 


CONTENTS 


PICTURE 


Options; 


NODATA 

NOFLOW 

NOSTRUCTUPF 


Opt  ions ; 


TLCC.NDLCC 
COMMENT, NOCO EM iNT 
DEFINE , NODE E IN E 
f ESU , NODESG 
ALL-STATEMENTS, NAF 
LIhE-FUhB2FS,NLNS 


COMPLEMENTAFY-STArFMEMS,  NCCNP 


rFINT-EOF,  NFEOF 


EXTENDFD- PICTURE 

Options: 


DATA  FLOW, STRUCTURE 
PACKWAFD,FOFNAhD 


PFOC ESS® CHAIN 

The  Data  Process  Feport  could  be  very  beneficial,  especially 
since  it  produces  a very  complete  description  of  data  flow  and 
process  functions.  It  can  be  used  when  an  overall  interaction 
description  is  needed.  This  report  also  shows  if  consistency  in 
present  as  well  as  showing  completeness  (or  i nccmpletenesn)  . 

The  STOP  command  should  not  be  used.  There  are  three  options  ot 
the  SET  command  that  should  not  be  used;  FP0i\F?*CN  will 
virtually  destroy  the  document  being  produced.  It  is  also 
recommended  that  OUTrUT»XXX,  HEADTNG«ON,  and  r AFM*ON  not  be 
vised.  All  tour  ot  these  options  default  to  OFF. 


* Part  IV,  "User  requirements  AnalV7.er  Command  Description." 
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5.2.4  ffliiiiiifla  lain^s 


The  text  formatting  entries  allow  the  user  a great  deal  o t 
maneuvera bi lity  in  reqards  to  the  final  document  format.  At 
this  point,  a diagram  might  help  to  show  just  what  is  qoinq  on  a 
paqe  of  a document. 


TlTl.i- 


page  1 


\ top- 
' lino 


LINKS 


bottom- 


5. 2. 4.1  2 i fSUiiti JJ2  Sfimmajids 


There  are  three  kinds  of  formattinq  commands:  those  that  have 
effect  on  other  formattinq  commands,  those  that  have  immediate 
effect  on  the  document  and  those  that  have  a global  or  continuous 
effect.  For  the  first  kind,  the  following  option  can  be  used: 


♦FOFNAT 


Mt  I 

UfifiSmi 


Default  :0N 


If  OH  is  specified,  all  commands  preceded  by  are  treated  as 
documentation  generator  formattinq  commands  and  are  executed 
accordingly  by  the  Automated  Documentation  System. 


It  OFF  is  specified,  all  commands  preceded  by  "*"  are  treated  as 
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text  lines  and  will  ippeat  in  the  final  output  without  further 
consideration . 

If  IGNORED  is  specified,  all  commands  preceded  by  are 

treated  as  comment  mTien  and  will  not  be  executed  nor  will 
they  appear  in  the  final  output. 

The  *FORMAT  comma:. d,  when  used,  should  always  be  the  first  entry 
in  the  schema.  The  setting  of  *FOFMAI  can  be  changed  throughout 
the  source  by  specifying  the  command.  Whenever  it  is  reset  *o 
ON,  the  global  options  of  forraattina  assume  their  DEFAULT  value. 

The  following  options  can  he  used  for  commands  that  have 
immediate  effect: 

*NE  W-PAGS 

SkiD  to  the  top  of  the  next  page. 

•SKI P [ N ] Default:  N = 1 

Skip  N lines.  If  N is  qreater  than  the  number  of  lines 
left  on  a paqe,  th°n  this  ccmmand  causes  carriages  to  skip 
to  the  top  of  the  next  page. 

•HOLD- BLANK  [ N ] Default:  N = *l 

Check  to  see  if  N lines  are  left  on  this  page.  It  there 
are,  skip  N lin«s.  If  there  are  not,  skip  to  the  next  page 
and  then  skip  N lines.  This  option  insures  that  enough 
space  will  be  left  on  a single  page  for  a diagram  or  table 
to  be  written  in  manually. 

*HOLD(N]  Default:  N = 1 

The  rest  of  the  current  paqe  is  checked  *o  see  if  N lines 
are  left  on  the  page  (net  including  HEADING  or 
BOTTOM-LINES).  If  N lines  are  left,  the  next  line  of  the 
source  data  base  is  produced.  If  N lines  are  not  left  on 
the  current  page,  skip  to  the  top  of  the  next  paqe  and 
produce  the  next  line  of  source. 

These  options  are  present  at  the  commencement  (under  their 
default  conditions  and  can  be  changed  throughout  the  source)  and 
have  a global  effect: 

•TITLE  (OFF)  Default:  OFF 

(Title) 

If  a title  is  given,  this  title  is  put  on  the  top  of  each 
page.  If  OFF  is  given,  no  title  is  printed  on  each  page. 

•HEADING  (OFF)  Default:  ON 

(ON) 

If  ON  is  specified,  the  HFADING-tNTEY  for  the  last  section 
printed  is  put  at  the  bottom  of  each  page.  if  OFF  is 

specified,  the  HEADING-ENTRY  is  not  put  at  the  bottom  of 

each  page. 
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♦TOP-LINES  [ N ] 

Skip  N linos  at  tho  bottom  of  each  pane, 
to  10. 


Default:  N=  3 
Pan^o  is  from  C 


♦B0TT0K-LIN*S  [ N 1 

Skin  N linos  a*  the  bottom  of  each  pant, 
to  IP. 


Default:  N ~2 
Fange  is  from  0 


♦LINES  (N1  Default:  N=60 

N is  the  number  of  lines  to  bo  printed  on  a pane,  including 
Title  and  Heading.  Range  is  from  5 to  tC. 


♦SOURCE-MARGIN  ( N ] Default;  8 

N is  tho  numb?i  of  spaces  to  indent  the  actual  text 
material.  This  does  not  affec*  Analyzer  report 
indentation.  Fange  is  from  1 to  4(! . 


♦ H FADING- MARGIN  f N ] Default:  N = 10 

N is  the  number  of  spares  to  indent  a section  heading. 
Range  is  from  1 to  4C. 

♦HEADING-SKIP  ( X ] Default  N*2 

N is  the  number  of  lines  to  skip  before  printing  a 
section- header . Tho  amount  skipped  will  at  most  be  to  tho 
top  of  the  next  page.  Fanqe  is  from  C to  60. 

♦PFPOPT-CC  {OFF}  Default;  ON 

(ON} 

When  set  to  ON,  the  Analyzer  report  carriage  control  is 
engaged  whon  outputting  Analyzer  reports.  This  affects 
page  feeding  of  the  document  produced,  when  OFF,  the  line 
skipping  and  page  feeding  is  controlled  by  only  formatting 
commands. 


It  is  important  for  the  documentor  to  understand  the  formatting 
commands.  There  are  several  points  that  should  be  remembered 
when  using  the  commands.  These  are  covered  in  the  following 
subsect  ions . 


5. 2. 4. 2 Defaults  qf  format t jng  Commands 

The  formatting  options  can  be  changed  at  any  time  in  the  Source. 
The  formatting  commands  defaults  affect  how  the  document  will 
appear.  If  one  does  not  specify  a value  for  these  commands, 
then  the  default  will  be  used.  when  the  documentor  does  not 
specify  these  command  values,  then  the  final  document  will 
appear  as  if  the  defaults  were  included  in  the  Source  data  base. 
The  formatting  command  defaults  depending  on  whether  ♦FORMAT  is 
ON  or  OFF  are: 
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* FOPH AT  ON 


♦FEPOFT-CC  ON 
♦TITLE  OFF 
♦HEADING  ON 
♦TOP-LINES  3 
♦POTTOH-LIN*,S  2 
•LI NFS  6o 
♦SOUPCF-MAFGIN  5 
♦HEADING-HAFGTN  S 
♦HEADING-SKIP  2 


♦ FOFK  A’’"  OFF  or  IGNOFE 


* FEPOFT-CC  OFF 
♦TITLE  OFF 
♦HEADING  OFF 
•TOP-LINFS  0 
♦BOTTOM-LINES  G 

♦SOURCE— KARGIN  1 
♦HEADING- FAR GIN  1 
♦HEADING-SKIP  0 


The  last  occurrence  of  each  option  is  the  one  in  effect.  The 
formatting  commands  in  the  Source  logically  succeed  the  command.* 
in  the  Schema  and,  thus,  override  Schema  commands  at  the  time 
they  are  encountered  in  the  Source.  The  ♦FOR  FAT  ON  command 
always  resets  the  other  formattinq  parameters  to  their  default 
values.  when  the  * FOR  HAT  OFF  command  is  in  effect,  no 
formatting  is  performed  in  Phase  III  of  the  Automated 
Documentation  System  for  that  portion  of  the  document  affected. 


5 . 2 . 4 . 3 •.  n a l y z e r Report  Indentation 

Analyzer  report  identation  is  not  affected  by  either 
•HEA  DING- MARGIN  or  ♦ SOU FCI>  K AF  0 1 N . Cate  must,  be  taken  in 
settinq  these  two  options  so  the  document  beinq  produced  is  in  a 
logical  readable  format  and  fits  on  *ht  size  of  paper  desired. 


5.  2.4.4  LINE  SKIPPING 

♦HEADING- SKIP  reacts  the  same  way  as  *$KIP  does  whor.  an  end  of 
paqe  is  encountered.  Also,  the  documentor  should  be  careful 
when  tryvnq  to  set  up  a section-header  so  it  starts  on  a new 
paqe.  If  the  value  of  *SKIF  or  •HFADEH-SKIP  is  more  than  the 
current  LINES  values  then  the  qeneratoi  automatically  skips  to 
the  top  of  the  next  paqe. 


S.2.4.5  ysage  o£  ♦FEPOFT-CC 

The  *FFPOPT-CC  command  specifies  whether  to  use  the  Analyzer 
FFTORT  Carriaqe  Control  symbols  or  to  suppress  them.  ♦FEPOFT-CC 
ON  means  that  the  normal  carriaqe  control  for  the  Analyzer 
reports  will  be  used.  OFF  means  that,  they  will  be  suppressed 
and  the  usual  paqing  sequence  for  the  document  will  be  used. 

Usage  of  the  *FEPOFT-CC  command  will  have  a direct  bearing  on 
the  paqinq  of  the  document  being  processed.  Since  when 
♦PEPOFT-CC  is  ON,  analyzer  reports  will  be  produced  according  to 
their  normal  paqinq  sequence.  This  is  helpful  when  a FICTUFF 
Report  is  being  produced  and  more  than  one  name  is  input  or  the 
PICIUFE  must  be  continued  on  the  next  paqe.  Other  reports  where 
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this  option  is  helpful  aru  the  DATA-PROCESS  Feport  and  th° 
CONSISTS-COMFARISON  Report.  In  cases  where  a report  will  be 
taking  up  no re  than  one  paqe,  it  is  important  to  start  the 
report  at  the  top  of  a fresh  paqe  so  that  the  Analyzer  paqinq 
will  natch  the  documentation  qenerator's  paqinq.  There  are 
cases,  thouqh.  where  the  documentor  will  wish  to  set  *REPOFT-CC 
OFF,  such  as  where  several  names  are  beinq  entered  into  the  FPS 
Report  or  CCNTFNTS  Feport. 


5. 2. 4. 6 The  *HOLP  and  • HOLD- PLANK  Commands 

The  documentor  should  understand  the  usefulness  of  the  HOLD  and 
HOLD-BLANK  commands.  If  a diaqram,  table  or  fiqure  must,  be 
drawn  manually,  the  HOLD-BLANK  command  should  always  be  used. 
This  will  insure  enough  space  is  saved  on  one  complete  page  to 
insert  the  fiqure.  If  an  analyzer  report  or  some  text  material 
is  going  to  be  produced  and  the  documentor  wishes  that  this 
material  be  contained  on  one  page,  'he  HOLD  command  should  be 
used.  An  example  of  where  it  would  be  used  is  with  the  PICTURE 
Report.  Since  the  PICTURE  Feport  uses  41  lines,  the  documentor 
should  place  a *HOLD  41  preceding  the  PICTUFE  command  to  insure 
'hat  it  is  Droduced  on  a single  page. 


S. 2. 5 Usage  of  Analyzer  SYNONYMS 

A SYNONYM  is  a short  abbreviation  form  of  a name  that  can  be 
stored  in  the  Analyzer  data  base.  A SYNONYM  is  a reserved  word 
of  the  Analyzer. 

In  order  to  generalize  the  documentation  Source  data  base, 
SYNONYMS  should  be  used  whenever  possible  to  describe  certain 
items,  such  as  main  functions,  master  files,  etc.  The 
implication  of  this  practice  on  the  Analyzer  data  base 
formulation  is  discussed  in  section  4.3,2. 

By  usinq  SYNONYMS,  the  documentor  is  relieved  of  changing  even 
more  of  the  Source  data  base  from  one  project  to  the  next.  An 
example  of  how  this  can  be  done  is  in  section  3.2  of  the 
Functional  Description.  The  Source  data  base  will  look  as 
follows : 

*3.2  SYSTEM  FUNCTIONS 

<NG  S=' MAIN-PFOCFSS  AND  SL=1*  NOPFINT 

THE  V AF 10  US  SUB- FUNCI IONS  OF  THE  SYSTEM  AFF: 
K-PCCM  DESC  PF CD  NCPUNCM 

In  this  example  MAIN-PROCESS  is  a SYNONYM. 

Section  2.4. 2. 4 is  another  example. 
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A.  OPFFATIONAL  STFUC^UFE 
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*STR 
♦SKIP  2 

B.  TIMELINESS  (OPERATIONS  AND  DATA) 

%FREQ 
♦SKIP  2 

C.  INPUTS 
*STF  INPUT 
♦SKIP  2 

D.  DATA  FETENTION 
1.  MASTER  FILE 

UPCOM  N=MASTER- FILE  DESC  DEP  NOPUNCH 
♦NEW-PAGL 

*PIC  N =MASTF.R-  FILE  NODATA  NCFLCW 
Here,  MASTEP-FILF  is  a SYNONYM. 


5.3  Development  of  the  Analyzer  Data  Base  with  the  Document 
Generator  in  MinH~  “ ~ ~ 

There  are  two  situations  that  can  occur  in  relation  to  the 
Analyzer  data  base  when  usinq  the  Document  Generator.1 

The  Analyzer  data  base  has  either  been  written  with  the  document 
to  be  produced  in  mind,  or  it  has  not  been.  In  any  case,  it  is 
going  to  be  beneficial  for  the  documentor  to  write  or  update  the 
Analyzer  data  base  in  such  a way  as  to  facilitate  ease  of 
production  of  the  document  using  the  generator.  Various 
practices  can  be  used  by  the  documentor  to  accomplish  this. 

These  practices  are  explained  in  the  following  subsections. 


5.3.1  Usage  of  MEMO 

When  it  is  necessary  to  describe  certain  aspects  of  a propsed 
system  that  are  general  in  nature  but  do  not  apply  directly  to 
the  structural,  functional,  or  data  flow  of  the  system,  then  the 
usage  of  MEMOs  in  the  Analyzer  data  base  can  be  very  helpful. 
When  objectives,  background  material,  requirements,  impacts, 
etc.,  are  needed,  a MEMO  is  the  obvious  answer.  Hence,  simple 
PUNCH-COMMENT- ENTRY  is  all  that  is  needed  in  the  documentation 
source.  An  example  of  a typical  MEMO  is  shown  below.  This  MEMO 
relates  the  objectives  required  for  Section  2.2  of  the 
Functional  Description: 
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MEMO  OBJECTIVES— MEMO; 

DESCRIPTION; 

THIS  PROJECT  HAS  BEEN  AUTHORIZED  TO  DFVELOF  A PAY  SYSTEM 
FOR  THIS  ORGANIZATION.  THIS  PAY  SYSTEM  WILL  PEFFOPM 


1 Note;  All  capitalized  names  in  this  section  refer  to  URL 
Reserved  Words.  For  a more  detailed  explanation,  refer  to  Parts 
I and  II  of  the  URL  User's  Manual. 
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PAYROLL  PROCESSING  USING  EMPLOYEE  INFORMATION  COMING  FROM 
DEPARTMENTS  ANT  EMPLOYEES  AND  WILL  PPOCUCE  OUTPUTS  WHICH 
WILL  GO  TO  THE  DEPARTMENTS  AND  EMPLOYEES.  THE  SYSTEM  WILL 
ALSO  MAINTAIN  THE  PAYROLL  MASTFF  INFORMATION. 


5.3.2  Usqge  21  ^d  SYNQjiYJlS 

when  the  documentor  or  analyst  is  constructing  Analyzer  data 
bases,  one  should  keep  in  mind  what  Analyzer  NAMES  and  SYNONYMS 
have  been  used  in  previous  documentation  source  data  bases.  The 
documentor's  work  can  be  reduced  if  common  names  are  used  to 
describe  similar  sections  ot  Analyzer  data  bases  which  are 
describing  systems  that  will  have  to  be  documented  under  the 
same  standard.  For  instance,  a documentor  might  want,  to  include 
sections  called  BACKGFOUND-MFMO  an!  CBJECTIVF-MFMO  when 
developing  Analyzer  data  bases  to  be  documented  using  the 
Functional  Description  Standards.  The  documentor  might  also 
want  to  have  an  ATTFIB'JTE  named  DEVELOPMENT-TIMES  in  these  Data 


Bases. 

An  example  ot 

ATTRIBUTE  usage  follows: 

DEFINE 

DEVELOPMENT-TIMES 

AS 

A ATTRIBUTE; 

/*  VALUES  AFF: 

MAN-HOURS- 120 

FOF 

PROGRAMMING, 

PLENTY  FOR 

COKPUTEP-TIME, 

M AN- HOU  FS- ICO 

FOR 

MAN-HOUFS-20 

DAT A- BASF- DEVELOPMENT, 

FOR 

MAN-HOURS- 3C 

PAYROLL- CLERICAL, 

FOR 

V 

OPERATIONS, 

SYNONYMS  can  be  used  in  similar  fashion.  If  the  documentor  uses 
similar  synonyms  in  ejch  data  base,  his  editing  can  be  reduced. 
Examples  of  this  are  using  MASTFF-FILE  as  a SYNONYM  tor  the  main 
file  of  the  system  and  using  MAIN- PROCESS  as  a synonym  for  the 
highest  level  function  in  the  system. 


5.3.3  Completeness 

There  are  three  areas  in  which  the  documentor  or  analyst  should 
strive  to  achieve  completeness  in  the  Analyzer  data  base.  These 
areas  are  data  flow,  system  structure,  and  functional  flow. 

Data  flow  should  be  complete  in  that  all  files  or  data  sets  are 
accounted  for.  This  means  that  data  definition  should  be 
included.  Elements  of  data  sets  need  be  defined  only  to  the 
level  of  description  required.  Th^  CONTENTS  Report  is  a good 
means  of  checking  data  description  completeness.  Usage  of 
UPDATES,  DF.FIVES,  GENERATES,  FECFIVFS,  and  USES  statements  is 
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the  vehicle  by  which  data  flow  information  i3  presented. 

System  structure  must  be  complete  for  obvious  reasons.  The  SrRUCTURE 
Report  is  helpful  in  checking  and  representing  the  information. 

v 

FVmctional  flow  is  perhaps  the  trickiest  facet  in  the  development  of 
the  Analyser  data  base.  Care  must  be  taken  to  insure  that  a functional 
chain  of  EVENTS,  CONDITIONS  and  PROCESSES  exists  in  a meaningful 
fashion.  Usage  of  TRIGGERS,  ON  TERMINATION  OF,  ON  INCEPTION  OF, 

CAUSES,  MAKES,  HAPPENS,  and  WHEN  statements  is  suggested.1 


5.3.4  DESCRIPTIONS 


The  documentors  should  keep  in  mind  Uiat,  in  many  cases,  descriptions 
in  the  form  of  text  on  different  aspects  of  systems  will  be  needed. 
The  DESCRIPTION  statement  can  be  used  by  the  documentor  to  meet  those 
text  requirements . The  documentor  should  include  a DESCRIPTION  with 
all  major  sections  of  an  Analyser  data  base,  as  well  as  any  other 
descriptive  statements  that  are  deemed  necessary  (i.o.,  PROCEDURE, 
VOLATILITY-SET,  etc.). 


5.3.5  Usage  of  KEYWORDS 

When  one  or  more  objects  in  a system  description  need  to  bo  identified 
for  selection  and  analysis  purposos,  KEYWORDS  should  be  attached  to 
oach  of  the  objects.  Ify  doing  this,  the  documentor  has  a link  between 
related  objects.  For  example,  if  all  functions  (PROCESSES)  described 
as  being  manual  procedures  in  a system  description  wore  to  be  listed 
and  analyzed  together,  the  KEYWORD  "manual"  could  be  attached  to  each 
PROCESS  for  this  purpose.  E(y  doing  a NAME-GEN  with  the  option  KEY= 

MANUAL,  a list  of  these  PROCESSES  could  then  bo  produced. 

| 

1 See  Part  I of  the  URL  Manual  for  an  explanation  of  these  terms. 
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This  appendix  presents  all  (1PA  commands,  with  their  parameters 
and  defaults.  It  also  presents  t.he  acceptable  abbreviations  for 
these  commands  and  parameters.  There  are  several  conventions  in 
choosing  these  abbreviations  that  may  aid  the  user: 

1.  For  command  names  that  consist  ot  only  one  word,  for 
example,  CONTENTS  or  riCTUFE,  the  first  three  or  four 
letters  of  the  name  are  used  as  their  abbreviation.  CONT 
is  the  abbreviation  tor  CONTENTS  and  PIC  is  the 
abbreviation  for  PICTUFE. 

2.  For  most  command  names  that  consist  of  more  than  one  word, 
e.g.,  CONSISTS- NAT  FIX  or  FOR  N AmTL  D- PFO  BL  Eh-STATEKFNT  , the 
abbreviation  is  derived  by  using  the  first  letter  from  each 
word  in  the  command  name.  This  gives  CM  for 
CONSISTS-MATFIX  and  FPS  for  FOPKA?  TED- PROP LEN- STATEMENT, 
This  convention  is  not  strictly  followed  however,  so  that 
the  abbreviations  may  be  more  meaningful.  For  example, 

DCOM  is  the  abbreviation  for  DFLETE-CCMMtNT-L'NTFY  which  is 
more  mnemonic  than  DCF. 

3.  Abbreviations  for  parameters  used  in  the  same  way  by 
several  commands  are  the  same.  The  FILE  parameter  then, 
always  has  an  abbreviation,  F,  no  matter  which  command  is 
using  it.  Some  of  the  more  common  parameters  are  listed 
below: 

£a£MGt2£  ii?R&yiaiifir 

FILE  F 

NAMF  N 

INPUT  I 

NOPRINT  NP 

PUNCH  P 

4.  Whenever  an  abbreviation  exists  for  a parameter  that  has  a 
"NO"  prefix,  such  as  NOPPINT,  the  abbreviation  is  always 
prefixed  with  "N".  For  example,  NP  is  the  abbreviation  tor 
NOPPINT. 

A blank  antry  in  the  "Parameters"  column  for  a command 
designates  that  there  are  no  parameters  for  the  command.  A 
blank  entry  in  the  "Abbreviations"  column  designates  that  there 
is  no  abbreviation  tor  the  command  or  parameter  name,  A blank 
entry  in  the  "Defaults"  column  designates  that  there  is  no 
default  for  this  parameter  for  the  oiven  command. 
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Co»nand  Name 

CH  AN GE- TY PE~ 

Parameters  Abbreviations 

FILL  F 

NAME  N ■ 

TYPE 

^e^aults 

CONSISTS- COMPARISON 

CNC 

FILE 

F 

FILF 

CONSISTS- MATRIX 

CM 

FILE' 

F 

FILS 

NAME 

N 

CONTAINED 

CN  TD 

CONSISTS 

CSTS 

CONTENTS 

CON"' 

FILE 

F 

FII  2 

NAME 

N 

INDEX 

1 ‘ 

NOIN  DEX 

NOINDF.X 

LEVELS 

LLVELS  = ALI. 

NCFLAG 

NONC  FLAG 

NONC FLAG 

PPINT-SECUFITY" 

INFORMATION 

PSI 

PFINT-Si’CRFI  rr 

INFORMATION 

NOPM  NT-SFCUFIT 

Y— 

I NFOFMA'TION 

N PSI 

s 

DATA-PROCZ3S 

DP 

FILE 

F 

FILF 

NAME 

N 

DATA 

D 

* l 

PROCESS 

P 

DPM  AT 

DPMA” 

NOD PM AT 

DPANL 

DPANI 

NODPANL 

PM  AT 

PM  AT 

NOPMAT 

FANL 

FA  NL 

NOPANL 

DELETE 

DEI 

■ 

FILE 

F 

NAME 

N 



DELETE-COWMEN  T-FNTBY 

DC  CM 

DESCF IPTTON 

DESC 

NODE'SCFIPTION 

NPESC 

NODESCPIPTICN 

DEPI VATION 

DEF 

noderivatton 

NDFF 

noderivation 
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FALSE- WHILE 

FW 

NOFALSE- WH ILF 

NFW 

NOFALS2- WHTLF 

PPCCEDUP  E 

PRCD 

NOPF  OCEDMF  E 

NPRCD 

NOPPOCEDUP  F 

TRUE- WHILE 

TW 

NOTFUF-WHILE 

NTW 

NOTPUE-  WHUE 

VOLATILITY 

VOL 

NOVOI ATI  LIT  Y 

NVOL 

NOVOLATILITY 

VOLATILITY-MEMBER 

VOLM 

NOVOLATILITY- 

NVOLM 

NOVOLATILITY- 

MEMBER 

VOLATILITY-SET 

VOLS 

MEMBER 

NOVOLATILITY-SET 

NVOLS 

NCVOLATILTTY- 

SET 

FILE 

F 

NAME 

N 

PPINT 

P 

PRINT 

NOPF I NT 

NP 

DELETE- PS  L 

DPSL 

INPUT 

1 

INPUT  =term 

SOURCE 

s 

SOURCE 

NC SO URGE 

NS 

XRSF 

X 

NOXFEF 

NX 

NOXRFF 

DICTIONARY 

FILF 

DICT 

F 

FILE 

NAME 

INDEX 

NOINDEX 

N 

NOINDEX 

NUM- SPACE 

NS 

NUM- SPACE=2 

DESCRIPTION 

DESC 

DESCF I PTI ON 

NODESCFIPTION 

NDE3C 

KEYWOPDS 

KEY 

KEYWORDS 

NONE YWOFDS 

NKEY 

PESPONSIBLE-PD 

RPC 

FcSPONSIBLF-PD 

NORESPONSI BLF-PD 

NF  PD 

SYNONYMS 

SYN 

SYNONYMS 

NOSYNONYKS 

NS  YN 

DYNAMIC-ANALYSIS 

DA 

FILF 

F 

FILE 

FILE 

DYNAMIC-ANALYSIS- 

N 

MATFIX 

DA  MAT 

DAMAT 

NODYNAMIC- ANALYSIS 

:- 

MATFIX 

NDAMAT 

DYNAMIC-ANALYSIS 

DA  KL 

DANL 

NODYNAMIC- ANALYSIS 

NDANL 

OPDF.F 

ORDEF*BYTYPE 

UTILIZES 

NOUTILIZFS 

UTILIZES 
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LINKS 

LINKS=1 0C0 

ENTITY-IDENTIFIER 

El 

FILR 

F 

FILE 

NAME 

N 

IDENTIFIER 

▼ 

ENTITY 

r 

4< 

EXTENDED-PICTURE 

EP 

FILE 

F 

FILF 

NAME 

N 

INDEX 

NOINDEX 

KOINDFX 

STRUCTURE 

STR 

DATA- FLOW 

DF 

FORWARD 

FWD 

BACKWARD 

BKD 

DOWNWARD 

DOWN 

UPWARD 

UP 

THREAD 

NOTH  READ 

NOTHLFAD 

LINKS 

LINKS  = 1v)C  P 

COLUMNS 

CO  LS 

COLUMNS*1 1 0 

ROWS 

ROWS  * 39 

HORIZONTAL-POXES 

HB 

VERTICAL- POXFS 

VB 

FORMATTED-PKOBLEM- STATEMENT 

FPS 

ALL- STATEMENTS 

AS 

NAS 

NOALL- STATEMENTS 

NAS 

AMAFG 

AM 

AKARG*10 

BMAFG 

BM 

BMARG*25 

COMMENT 

COM 

COMMENT 

NOCOMMENT 

NCCM 

COMPLEMENTARY- 

COMP 

COMP 

STATEMENTS 

NOCOMPLENF.  NTARY- 

N COM  P 

STATEMENTS 

CMARG 

CM 

CM ARG  *1 

DEFINE 

DF  F 

DEFINE 

NODE  FINE 

NDEF 

DESG 

DG 

DESG 

NCDESG 

NDG 

DLC*  COMMENT 

DLCC 

DLC-COMMENT 

NODLC-COMMEN^ 

NTLCC 

EMPTY 

NOEMPTY 

FILF 

F 

FILE 

NAME 

N 

HMARG 

HM 

HM  ARG*4  1 

INDEX 

NOINDEX 

NOINDLX 

LINE-NUMBERS 

LNS 

LNS 

NOLI NE- NUMPTF  S 

NLNS 

h | 

jj 
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NSW-  LINES 

NL 

NONEW-LINFR 

NHL 

NQNFW- LINES 

NEW-  PAGF 

NPG 

NONEW- PAGE 

NNPG 

NONEW-PAGE 

KMAFG 

NH 

NHAFG»2'» 

ONE-PEF-LINF 

CPL 

ONF-PFF-I INI 

SF.VERAL-PFR-  LINE 

SPL 

PFINT 

P 

PFINT 

NOPFINT 

NT 

PFINTEOF  FOF 

PEOF 

NOPFINTEOF 

KPEOF 

PUNCH 

P 

NOPUNCH 

NOFUNCH 

RNHARG 

FK 

KNHAFG=Tf 

SflAFG 

SM 

SMARG*5 

FFKOUENCY 

INDEX 

NOINDEX 

FFFO 

NOINDEX 

OFDEF 

NEW-  FAGE 

NPG 

OFDEF  =DYTYPK 

NONLW-PAGF 

NNPG 

N 0 N E W-  r A G F 

HELP 

co«eand-name 

SHORT 

LONG 

SHOKT 

INPUT-PSL 

IP 

UBFEF 

D 

DDFFF 

NODBFEF 

ND 

INPUT 

I 

INPUT*tftI'm 

SOHFCF 

NS 

SOUFCF 

NOSOUFCE 

S 

UPDATE 

u 

NOT1PD  ATE 

NU 

NOUPDATF 

XREF 

X 

NOXFEF 

NX 

NOXFEF 

INTER VAl-CONSITNCY 

IC 

FILE 

F 

FILE 

NAME 

INDEX 

NOINDEX 

N 

NC1NDEX 

LEVELS 

LEVELS*ALL 

KWIC 

FILE 

F 

FILE 

DIF 

DIF»2 

LISf-CIIANGFS  LC 
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PRINT 

P 

PRINT 

NOPRINT 

NP 

USER 

NOUSEF 

NOUSER 

NAME-GEN 

NG 

EMPTY 

NOEMFTY 

OFDER 

ORDEF=BYTY  PE 

PFINT 

P 

PRINT 

NOPRINT 

NP 

PUNCH 

PUNCH 

NOPUNCH 

SELECTION 

S 

INPUT 

I 

INPUT  =term 

TIME-OF-LAST- 

1 

CHANGE 

TLC 

NOTIME-OF-LAST 

* 

- 

CHANGE 

NTLL 

NTLL 

NAME=LIST 

NL 

- 

ORDER 

OFDEF=BYTYPE 

COLUMN 

COL 

COLUMN=TYPE 

TYPE 

TYPE 

NOTYPE 

SYNONYM 

SYN 

SYNONYM 

NOSYKONYM 

NS  YN 

DATE-LAST-CHANGED 

DLC 

DLC 

NOrATE-LAST- 

CHANGFD 

NDLC 

’ 

PICTURE 

PIC 

DATA 

D 

DATA 

NODATA 

ND 

FILF 

F 

FILE 

NAME 

N 

FLOW 

FLOW 

NOFLOW 

j 

INDEX 

NOINDEX 

NOINDEX 

STRUCTURE 

STR 

STRUCTURE 

NOSTRUCTUPE 

NSTF. 

% 

PRI N T- A ITFT BUTE- VALUES 

PAV 

\ 

FILE 

F 

FILE 

NAME 

N 

' 

PROCESS-CHAIN 

PC 

- 

FILE 

F 

FILE 

NAME 

N 

INDEX 

NOINDEX 

NOINDEX 

LINKS 

LINKS=10C0 

DSPENDING-ON 

DFP 

I 

1 

Appendix  A URA  Conmand  Abbreviations 

\ 

1 

u 

UFA  User's  Manual 


502 


NODEPENDING-CN 

NDEP 

NODEPENDING-CN 

FOR- EACH 

FEA 

NOFOF-FACH 

NFEA 

NOFOF- EACH 

COLUMNS 

CO  IS 

COLUMNS  s 1 1 Q 

FOWS 

HOFIZONTAL-BOXES 

HB 

FOWSs39 

VEFTICAL- POXES 

VB 

PFOCESS-INPUT- OUTPUT 

FILE 

PF  10 

F 

FILE 

NAME 

K 

DESCRIPTION 

DLSC 

DESCRIPTION 

NODESCSIPTION 

NDESC 

PROCEDURE 

PFCD 

f.’OPFOCEDUF  F 

NPFCD 

NOPFOCEDUR - 

INPUT 

INF 

INPUT 

NOINPUT 

NINP 

OUTPUT 

OUT 

OUTPUT 

NOOUTPUT 

NOOUT 

NEW-  P AGF 

NPG 

NONEW- PAGE 

NNPG 

NONEW-PAGE 

PRINT 

P 

PRINT 

NOPFINT 

INDEX 

NOIKDFX 

NP 

NOINDEX 

PFOJECTFD-COS1-REFOFT 

PC  F 

FILE 

F 

FILE 

NAME 

N 

F.XPF  FSSION 

E 

INPUT 

1 

INPUT'term 

DEFAULT 

DEF 

DEFAULT3*: 

INDEX 

NOINDEX 

F5SCUFCE 

FSC 

NOINDEX 

UNITS 

U 

PUNCH-COMMENT- ENTFY 

DEFIVATION 

FCCM 

DER 

NODEF IVATION 

NDER 

NODEF IVATION 

DESCRIPTION 

DFSC 

NODESCSIPTION 

NDESC 

NOrESCIFPTION 

FALSE-WHILF 

FW 

NOFALSh- WHILF 

NFW 

NOFALSE-WHILE 

PROCEDUFF 

PPCD 

NOPOFCED  UF  E 

NPFCD 

NOPFOCt’DUFF 

TRUE-VHILF 

TW 

NOTRUF-WHILE 

NT  W 

NOTRU E-WHII F 

VOLATILITY 

VOL 

NOVOLATILITY 

N VOL 

NOVCLATII ITY 

VOLATILITY- MEMBER 

VOLM 

NOVOLATILITY- 

NVCLf* 

NOVOLATILITY- 

MEMBER 

VOLAIILITY-SFT 

VOL3 

MEMBER 
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N0VOLA7IIITY--SET 

NVOLS 

NOVOLATILITY- 

SET 

EMPTY 

NOEM  F7Y 

FILE 

F 

FILE 

NAME 

N 

PP.INT 

P 

PRINT 

NOPRINT 

PUNCH 

NOPUNCH 

NP 

NO PUNCH 

FFNAME 

FEN 

INPUT 

I 

OLD 

0 

NEW 

N 

EL’PLACE-COM  MENT-EfJTF  Y 

F.CCM 

i 9 

INPUT 

I 

INPUT 

PRINT 

P 

PRINT 

NCPFINT 

NP 

RESOURCE- CONSUMPTION- ANALYSIS 

FCA 

FILE 

F 

FILE 

NAME 

N 

PFOCESS- IE  VEL 

PL 

PL=ALL 

INTERVAL 

INT 

1 

BY  PF  OCFSSOF 

BP 

BY  PRCCESSOP 

NOB Y PROCESSOR 

NBP 

DYF  F SOUFCF 

BF 

BYRESOUFCE 

NOBYRESOUFCE 

INDEX 

NBF 

■ 

NOIN  DF. X 

NOINDEX 

PFOCESSOF-KEYWORD 

PK 

ALL 

.. 

SECURITY- CONSISTENCY  ANALYSIS 

SECA 

FILE 

F 

FILE 

NAME' 

PFINT-NULL- 

N 

■ 

SECUFITY- INFORMATION 

PNSI 

NOPRINT— NUI I— 

SECUPIT Y- INFORMATION 

) 

NPSI 

NPSI 

PFINT-N.  ATF  IX 

PM  AT 

PMAT 

NOPFI NT- MATRIX 
INDEX 

NPKAT 

i 1 

t | 

NOINDEX 

NOlNDEX 

STRUCTURE 

STF 

INDENT 

IND 

I N DENT=  3 

INDEX 

NOINDEX 

INPUT 

INP 

NOINDEX 

INTEFFACF 

INTF 

, 

Ai 
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OUTPUT  OUT 

PHOCFSS  PFOC  PROCESS 

FEAL- HO FLD- ENTITY1 

R HE 

FPOCESSOR  PFCF 


SUMMARY 


SUE 


1 FFAL- HOP LP* ENTITY  is  synonymous  with  INTERFACE  (INTF)  . 
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Before  the  user  can  add  information  to  a UFA  data  base,  the  data 
base  must  exist  and  be  initialized  properly.  Creatinq  an 
initialized  data  base  in  the  user's  working  directory  is  a 
simple  one-step  process.  The  user  should  type 

ec  >ml >CAFA>initdb  (name)  (size) 

The  size  parameter  is  optional  and,  it  given,  should  be  the 
desired  size  of  the  data  base,  chosen  from  these  sizes  presently 
available  (i.e,,  2f. , 5)f  IOC,  130).  The  default  size  if  not 
given  is  21.  The  name  parameter  is  also  optional  and,  if  given, 
is  the  name  that  URA  will  use  to  reference  the  data  base.  Note, 
a suffix  of  .dhf  should  not  be  given  by  the  user.  The  default 
name  used  if  name  is  not  given  is  ura.  If  the  size  parameter  is 
to  be  used,  then  the  name  must  also  be  giyen. 
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IlLttfiSS 

The  purpose  ot  the  data  base  dump  program  is  to  produce  a fi)< 
of  sequential  card  images  consist ing  of  all  names  and 
relationships  stored  in  a UFA  data  base.  The  file  is  in  a 
format  suitable  as  input  to  the  Data  base  restore  Program. 


iitisiJB-itisa  iisssnisi! 

The  data  base  dump  program,  PDPM,  produces  a report  in  the 
standard  UFA  format  and  dumps  the  contents  of  the  entire  UFA 
data  base  in  eighty-column  card-image  format  with  a sequence 
number  in  columns  73-Bb, 

The  report  shows  the  contents  of  the  card  images.  The  data  base 
dump  program  probes  every  possible  UFA  data  base  connection  and 
encodes  this  information  in  the  output  it  produces. 


Despite  the  many  different  types  ot  possible  relationships  in 
the  data  base,  the  intormat.ion  it  contains  is  written  using  only 
two  record  formats.  This  flexibility  is  achieved  by  using 
particular  fields  ot  a record  to  indicate  the  tom  and  type  ot 
information  in  the  other  fields  of  the  record. 

The  two  basic  formats  are  the  following: 


NAK3  FORMAT  (HO  Characters) 


12  7 10  40  43  73 

I............................  ...... ... ♦ 

I I I I II  | IP  I 

I I I I II  I I 


N2  l holds  a second  name  oi  number] 
T2  [indicates  type  of  information  in  N2  ] 
N 1 [holds  a name  or  a number  ] 

T1  [indicates  the  type  of  information  stored  in  Nl  ) 

TYP  [holds  numeric  name  or  relation  type] 

COPF  [indicates  type  of  relation  from  1-6  described  above] 


Numeric  codes  in  T1  and  T2: 

0:  field  not  applicable 
1:  field  contains  a name 
2:  field  contains  a number 
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COMMENT-ENTRY  FORMAT  (80  Characters) 


1 73 

— - --- - - - ..... — ----  --  , 

I I I 

I | ID  | 

♦ — ---- - --------- -- ♦ 


Comment  line  directly  from  data  base 


The  sequence  ot  these  card-imaqes  in  the  output  file  is 
important  since  more  than  one  record  is  often  required  to 
describe  a single  structure  in  the  data  base. 


inalxsis 

The  data  base  dump  program,  reproduces  the  contents  of  the  data 
base  in  six  steps,  to  process  the  six  general  forms  of 
relations.  The  six  categories  of  relations  are  as  follows: 

1.  The  set  called  ALLNAM,  which  owns  (consists  of)  all  names 
in  the  data  base. 


2,  The  SYNFOF  relation  which  links  synonyms  to  the  basic 
names. 


3.  Comment  entries  associated  with  a NAMFEC  record  (a 
particular  name)  via  set  FFLA  and  ALINE  records. 


4.  Simple  RELA-hELP  set  relations  (two-name  connections) 
conected  by  NH DA  records. 

5.  Complex  F3LA-FELB  relations  connected  by  NUBB  records  which 
may  or  may  not  own  a NUBC  record  via  R ELC  (three  and  four 
name  connections). 

6.  Complex  F £L A- FFLB  relations  connected  via  NUBC  records 
(four  name  connections). 


(jsflqps 

The  data  base  dump  program  provides  a means,  along  with  the  Tata 
Base  Restore  Program,  to  move  a UFA  data  base  from  one  system  to 
another  system,  regardless  of  differences  in  system  hardware  and 
software. 

This  program  is  also  useful  for  saving  the  current  status  of  a 
data  base  at  a given  checkpoint  in  time  on  some  off-line  medium 
such  as  magnetic  tape.  If  the  data  base  is  subsequently  damaged 
or  destroyed,  one  can  recover  by  restoring  the  data  base  to  its 
condition  at  the  time  ot  the  dump. 
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The  only  restriction  on  the  dunp  progran  is  that  the  data  base 
nust  be  a data  base. 


To  produce  a card  inage  dunp  of  a UFA  data  base  on  Multics,  the 
following  comaand  should  be  executed: 


ec  >ul >CARA>dunp  data- base-naae  output  punch 
where: 


data-base-naae  is  the  nano  of  UFA  data  base  to  be  dumped  (the 
".dbf*  qualifier  is  automatical 1 y added). 


output  is  the  nane  of  the  sequent  (file)  that  will  contain  the 
printed  listing  of  the  dunp. 


punch  is  the  nane  of  the  sequent  (file)  that  will  contain  the 
card*inage  dump  of  the  data  base. 


£lAAJ2l£ 

Figure  80  shows  a portion  of  the  report  produced  by  the  data 
base  duup  prograa. 
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Purpose 

The  purpose  of  the  Tata  Base  Restore  Program,  is  to  restore  a 
UPA  data  base,  acceptinq  the  card-image  format  output  generated 
by  the  Data  Base  Dump  Program.  The  sequence  numbers  on  the 
input  records  are  also  checked  for  consistency. 


Information  Presented 

The  data  base  restore  program,  PPES,  produces  a report  in  the 
standard  UPA  format  of  the  card  images  that  are  input  to  Restore 
Program.  The  program  also  prints  out  messages  concerning  the 
outcome  of  the  restore  process. 


format 

The  format  of  the  output  of  this  utility  is  similar  to  the 
format  of  the  report  produced  by  the  Dump  Program. 


Analysis 

The  UFA  data  base  is  restored  in  seven  steps  in  a manner 
corresponding  to  that  utilized  by  the  Dump  Proqram.  There  are 
eleven  subroutines  which  handle  such  tasks  as  the  interpretation 
of  the  input  records,  initialization,  Input/Output,  errors  and 
number  conversion. 


Usages 

The  data  base  restore  program  provides  a means,  along  with  the 
data  base  dump  program,  to  move  a UFA  data  base  from  one  system 
to  another  system  regardless  of  differences  in  hardware  and 
software,  and  to  provide  back-up  should  the  data  base  become 
damaged  or  destroyed. 

The  only  restriction  is  that  the  da'-a  base  must  be  a tJJjjA  data 
base. 


To  restore  a previously  dumped  UFA  data  base  the  following 
Sultics  command  should  be  executed: 


ec  >ml >CAF A>restora  data-base-name  output  input 
where: 
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data  base-name  is  the  name  of  an  empty  initialized  data  base 

where  the  restorationn  is  going  to  he  performed  (the 
".dbf"  qualifier  is  automatically  added). 

output  is  the  segment  (file)  that  will  contain  the  printed 
listing  of  the  input. 

input  is  the  segment  (file)  that  is  the  punch  segment,  from  the 
Dump  Program. 


Example 

Figure  31  shows  a portion  of  the  report  produced  by  the  Festore 
Program . 
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FESXOFF  VEFgXON  J.£  to  j.3  (PF23) 

Purpose 

The  purpose  of  the  Tata  Base  Pestore  Version  3.2  to  3.3  proqram 
is  to  restore  a 3.2  Version  UFA  data  base  to  a 3.3  Version, 
accepting  the  card-imaqe  format  output  generated  by  the  Version 
3.2  Database  Dunp  program.  The  sequence  numbers  on  the  input 
records  are  also  checked  for  consistency. 

Inf ormati on  Presented 

The  Data  Base  Restore  Program,  TF23,  produces  a report  in  the 
standard  URA  format  ot  the  card-images  that  are  input  to  PF23. 
The  proqram  also  prints  out  messages  concerning  the  outcome  of 
the  restore  process. 

Format 

The  format  of  the  output  of  this  utility  is  similar  to  the 
format  of  the  report  produced  by  the  DUMP  program. 

Analysis 

The  Version  3.2  UFA  'lata  base  is  restored  in  six  steps  in  a 
manner  corresponding  to  that  utilized  by  the  version  3.2  Dump 
program.  There  are  thirteen  subroutines  which  handle  such  tasks 
as  the  interpretation  of  the  input  records,  initialization, 
Input/Output,  ■ rrors  and  number  conversion. 

There  is  one  subroutine  dealing  particularly  with  the  HAPPENF 
statement  which  has  been  changed  to  a new  structure  in  version 
3.3.  Another  subroutine  handles  the  GENERATES  and  RECEIVES 
statements  which  have  also  been  changed  internally.  The  Program 
generates  a data  base  with  new  structures  that  are  compatible 
with  the  version  3.3  UFL/URA  software. 


Usages 

The  Data  Base  Restore  Version  3.2  to  3.3  program  provides  a 
means  to  revise  a 3.?  data  base  to  be  compatible  with  the  3.3 
IJFL/UFA  sofware. 

The  only  restrictions  ar**  that  the  data  base  must  be  a UPA  3.2 
data  base  and  that  the  data  base  has  been  dumped  by  a 'JRA  3.2 
Dump  program. 

To  restore  the  previously  dumped  MPA  duta  base  the  followirq 
Multics  command  should  he  executed: 

ec  >ml>CAFA>pr23  dat a_base_name  output  input 


where: 
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data^base^name  is  the  name  of  an  empty  initialized  3.3  data  base 
where  the^restoration  is  goinq  to  he  performed  (the  ".dhf" 
qualifier  is  automatically  added). 

Output  is  the  segment  (file)  that  will  contain  the  printed 
listing  of  th-3  input 

input  is  the  sequent  (file)  tha*  is  the  punch  segment  from  the 
3.2  Dump  Proqram. 

Example 

Figure  82  shows  a portion  cf  the  report  produced  by  the  PF23 
program . 
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USACE  H2N.H0F  PY  COM  MAN  T 1 F fOFT 
Purpose 

The  purpose  of  the  Usaqe  Monitor  by  Command  report  is  to  produce 
a summary  report  of  all  Analyzer  commands  us°d  during  a certain 
period  of  time. 

In  t ogma  t j on  Presented 

The  Usage  Monitor  by  Command  report,  UMC,  produces  a list  of  all 
Analyzer  commands  given  the  number  of  times  each  mas  used,  and 
the  percentage  of  the  total  nuber  of  commands  for  each  command. 
The  same  information  is  presented  for  the  parameters  given  with 
each  command.  t summary  of  the  total  number  of  commands  and 
parameters  for  each  command  is  also  qiven. 

Format 

The  information  is  listed  in  a table.  The  command  and  its  usaqe 
statistics  are  on  the  left  side  of  the  report.  The  parameters 
aiid  their  statistics  are  presented  on  the  riqht  side  of  the 
report,  beside  the  cor respondinq  command.  The  summary  totals 
appear  at  the  bottom  of  their  respective  lists. 

Analysis 

The  UMC  proqram  utilizes  a file  mairtained  by  the  Analyzer 
called  the  Statistics  File.  Each  time  as  user  issues  a command 
to  the  Analyzer,  this  command  and  statistics  about  its  execution 
are  appended  to  the  Ftatistics  File.  I he  UMC  program  reads  the 
commands  and  pirameters  from  this  file,  checks  their  legality 
(assigning  non-leqal  commands  and  parameters  to  the  "INVALID  QB 
OTHEF"  cateqory) , and  counts  the  number  of  each  command  and 
parameter.  After  the  entire  tile  has  beer,  piocessed,  the 
percentages  an!  summary  statistics  are  computed,  and  the  repett 
is  prod-  ed , 

Usages 

The  Usage  Monitor  by  Command  report  provides  a means  to  monitor 
the  use  of  the  individual  Analyzer  commands  and  parameters.  Cf 
particular  interest  would  be  those  commands  and  parameters  used 
the  most  and  those  used  the  least.  The  number  of  each  command 
is  an  indication  of  the  kinds  of  analyses  being  performed.  It 
might  show,  tor  example,  that  insufficient  analysis  commands  are 
being  used. 

Example 

Figure  ^3  presents  an  example  of  the  Usage  Monitor  by  Command 
report . 
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The  purpose  of  the  Usage  Monitor  by  User  program  is  to  produce  a 
report  on  the  usage  of  the  Analyzer  by  various  persons  and 
projects  during  a certain  period  cf  time. 

Informa ti on  Presented 

For  each  Account. pro ject  id.  the  number  of  sessions,  the  number 
of  commands  and  the  amount  of  cpu  and  real  time  consumed  by  the 
Analyzer  is  given.  A summary  for  all  users  of  the  Analyzer  is 
also  given. 


The  heading  of  the  report  shows  the  date  and  time  span  that  the 
report  covers  and  the  date  and  time  of  the  report  generation. 

The  body  of  the  report  consists  of  five  columns.  The  left  most 
column,  "ACCOUNT  P5CJECT"  identifies  the  account  number  or 
computer  center  id  of  the  user  and  the  project  identification. 
The>number  of  times  the  person  used  the  analyzer  is  given  under 
the  SESSION F column.  The  percent  of  total  sessions  for  each 
user  is  also  displayed.  The  next  column,  COMMANDS,  presents  the 
total  number  and  the  percent  of  grand  total  of  Analyzer  commands 
issued  by  the  user.  The  last  two  columns  show  the  amount  of  CPU 
and  real  time  used  by  the  Analyzer  in  performing  the  commands. 
The  last  line  of  the  report  shows  the  grand  totals  of  the 
sessions,  commands,  CPU,  and  real  time. 

Analysis  The  UMU  Program  utilizes  a file  kept  by  the  .Analyzer 
called  The  Statistics  File.  Tach  time  a command  is  given  to  the 
Analyzer,  this  command  and  various  statistics  about  its 
execution  are  recorded  in  the  Statistics  file.  The  UMU  nroqram 
processes  the  Statistics  File  seauentially,  accumulating  the 
number  of  sessions,  commands,  CPU,  and  real  time  for  .»ach  user 
encountered.  The  Statistics  File  is  sorted  by  user 
identification  prior  to  the  execution  of  the  UMH  module.  V’hen 
the  end  of  the  file  has  been  reached,  the  percentages  and  totals 
arejcomputed  and  the  report  is  produced. 


The  Usage  Monitor  by  User  report  provides  a means  to  monitor  the 
usage  or  th^  Analyzer  by  various  Account. Prolect  id’s.  This 
information  may  be  useful  to  project  management  to  determine  who 
is  using  the  Analyzer,  and  how  much  each  person  is  using  it. 

Example 

Figure  34  presents  an  example  of  the  Usaqe  Monitor  by  User 
report , 
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DATA  BASE  STATISTICS  PROGRAM  iDPSJ. 


Purpose 

The  purpose  of  the  Data  Base  Statistics  Program  is  to  generate  a 
URA  Data  Base  Statistics  Feport.  This  report  is  rather 
technical  and  is  intended  for  users  familiar  with  the  operations 
of  the  data  base  system. 


Lon  Presented 


The  UFA  data  base  statistics  report  consists  of  three  different 
tables,  which  show  how  many  set  occurrences  of  different  sets 
and  how  many  record  occurrences  of  different  records  have  taken 
place,  and  how  they  are  related. 


Format 

The  format  of  the  Data  Base  Statistics  Report  is  similar  to  the 
format  of  the  URA  reports.  For  a large  data  base,  this  report 
can  be  rather  voluminous. 


Analysis 

The  data  base  statistics  program  prints  out  three  tables: 

For  the  first  table,  the  program  checks  for  the  value  of  several 
internal  switches.  If  the  NAME  switch  is  true,  the  name  and 
information  about  each  record  is  printed;  if  it  is  false  no 
information  is  printed.  If  the  NAME  NUB  switch  is  true,  the 
code  number  for  the  relation  type  between  different  records  and 
other  relevant  information  is  printed.  If  the  SYNONYM  switch  is 
true,  synonyms  and  their  code  number  are  printed. 

For  the  second  table,  the  program  prints  the  total  number  of 
occurrences  of  different  sets  and  total  number  cf  record 
occurrences  of  different  records. 

For  the  third  table  the  program  prints  out  the  code  numbers  of 
different  relation  types  with  the  sets  FELA  and  FELB. 


lisaass 

When  a UFA  data  base  is  being  initially  populated,  sometimes  is 
useful  to  know  how  many  different  relationships  are  stored  ir. 
the  data  base.  The  different  relation  types  are  represented  in 
the  sets  FELA  and  FELB.  The  DBS  program  may  be  used  to  print 
this  information. 
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This  program  is  not  at  all  similar  to  the  SUMMARY  command  in  URA 
nor  the  Data  Base  Summary  Program.  The  SUMMARY  command  presents 
a summary  of  the  number  of  each  type  of  URL  object  contained  in 
the  URA  data  base.  The  Data  Rase  Summary  Program  (DBSM) 
displays  the  physical  utilization  summary  such  as  the  number  of 
data  base  records  (pages)  used,  the  number  of  name  records,  nubb 
records,  and  set  statistics. 

To  produce  a DBS  report  of  a URA  data  base  the  following  Multics 
command  should  be  executed: 

ec  >ml>CARA>dbs  data-base  output 
where: 

data-base  is  the  name  of  the  URA  data  base  for  which  the 

statistics  report  is  desired  (the  .dbf  suffix  is 
automatically  added)  . 


output  is  the  name  of  a segment  (file)  that  will  contain  the 
printed  listing  of  the  statistics  report. 


Examples 

Figure  85  contains  a portion  of  the  Data  Base  Statistics  Report. 
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Any  problems  arising  from  the  use  of  UFA  software  should  be 
reported. 

Problems  may  be  reported  while  usinq  Kultics  interactively  by 
issuinq : 

mail  * Wizard  CAPA 


message 


The  message  should  contain: 

1.  your  name 

2.  your  person  id 

3.  your  project  id 
i».  the  date 

5.  the  data  base  you  were  working  with 
t>.  the  command  you  were  using 

7.  a short  explanation  of  what  happened 

8,  the  names  of  any  segments  used  (be  certain  that  read 
access  be  given  to  *.CAFA.*) 


"he  user  organization  should  complete  a CAF.A  PhCULEM 
FEPOPT /CHANGE  FSQUES1  FOFK  and  forward  it  to  ESP.  Copies 
of  this  form  are  available  from  ESD. 
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(Version  3. 3 of  UFA) 

This  appendix  summarizes  the  specific  information  that  a user 
must  have  in  order  to  use  the  Analyzer  in  a Multics 
environment,.1  This  appendix  consists  of  several  sections: 

1)  UFA  Control  commands  for  Multics 

DISPLAY  command 
HELP  command 


The  HELP  command  has  been  expanded  and  improved  for  Multics 
users.  The  revised  command  description  is  included  here. 

MTS  command 
SET  command 
STOP  command 

These  commands  can  be  used  when  using  URA  under  Multics  (in 
addition  to  the  other  commands  presented  in  Section  IV  of 
this  manual)  . 

2)  Data  Set  Naming  Conventions  for  Multics 

2.1  Naminq  the  Data  Base  File 

2.2  Naming  Temporary  Data  Sets 

This  section  describes  what  naming  conventions  should  be 
followed,  and  what  the  Analyzer  does  to  enforce  the 
conventions, 

3)  Notes  on  Executing  UFA  under  Multics 


3.1  Creating  and  Initializing  UFA  Data  Bases 

3.2  Executing  the  Analyzer  under  Multics 

3.3  Example  URA  session 


4)  Multics  Default  Data  Set  Names 

This  part  presents  the  default  data  set  names  used  by  the  UFA 
commands. 


5)  Multics  glossary 

This  section  explains  some  of  the  terminology  used  in  this 
appendix. 


1 For  a better  understanding  of  Multics  see  the  Multics 
Programmer's  Manuals. 
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A Note  on  Version  3.3  of  URA 


There  are  several  important  charqes  that  have  been  made  in  UFA 

which  make  Version  3.3  ditterent  from  Version  3.2.  Thtse  are 

listed  below. 

1)  Several  interval  modifications  (which  are  transparent  to 
the  user)  have  been  made  to  make  UFA  more  efficient  in  the 
Multics  environment. 

2)  A few  errors  in  Version  3.2  have  been  corrected. 

3)  There  are  four  new  commands  - DYNAMIC- ANALYSIS, 
INTERVAL-CONSISTENCY,  LIST-CHANGES,  PFOJFCTF.D-COST-  FEPOFT . 

4)  Several  commands  have  new  parameters  - 
FORMATTED- PROBLEM- STATEMENT,  FX TEN DED- PICTURE , 
PROCESS-CHAIN,  NAME- GENERATION,  NAMF-LIST. 

5)  There  are  three  new  utilities  - US  AGE- MONITOR-USER , 
USAGF-MONITOE-COMMAND,  PR23. 

6)  The  Automatic  Cocumentat ion  can  now  be  used  in 

conjunction  with  the  Multics  runoff  text  editing  processor. 

7)  The  HELP  instructions  have  been  revised  and  expanded. 

S)  Abbreviations  for  the  PRINT  NOTRINT  parameters  have  been 
standardized  as  P and  NP  respectively.  There  is  no 
abbreviation  tor  the  PUNCH  parameter. 
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Comaand:  DISPLAY  Type:  control  command 

Purpose:  To  display  the  current  settings  of  the  global 

switches  and  parameters. 

Prototype:  TISLAY (DIS) [ parameter  ]. . . 

Parameters: 

ALL  Default:  ALL 

others  (see  below) 

When  the  ALL  paraaeter  is  qiven,  the  values  of  all 
the  global  switches  and  paraaeters  are  printed  at  the 
terainal  (in  interactive  mode),  or  on  the  line 
printer  (in  batch  mode).  The  parameters  printed  ate 
those  given  in  the  set  command  description. 

When  any  of  the  following  parameters  are  qiven.  the 
current  value  associated  with  it  is  given.  This 
command  only  displays  the  value  of  the  parameters: 
the  SET  command  is  used  to  change  their  values.  The 
function  of  each  paraaeter  is  given  in  the  SET 
command  description. 

data-base  (db) 
echo (e) 
heading  (h) 

1 ines  (1) 
output  (o) 
parameters (parm) 
problem-name (pnam) 
prompt  (p) 

Examples:  DISPLAY  ALL 

DIS  DP  ECHO  0 
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Command:  HFLP1 

Purpose:  To  provide  the  on-line  user  with  a list  of  possible 

commands  for  UFA  cr  information  about  the  parameters 
for  a particular  UFA  command. 

Prototype:  HELP  [parameter]... 

Parameters: 

Command-name  Default:  (See  text) 

If  no  command-name  is  qiven,  a list  of  currently 
available  URA  commands  and  utilities  is  given.  If  a 
comman d- name  is  given,  then  the  parameters  for  that 
command  are  presented.  Abbreviations  tor  the 
command-name  are  also  acceptable. 

If  a utility  name  is  given,  such  as  DUMP  or  FESTOPE, 
then  the  description  of  the  Multics  commands 
necessary  to  execute  the  utility  is  presented. 
Abbreviations  are  PDUM  and  PFES. 

FILES  Default : (See  text) 

If  this  parameter  is  given,  a list  of  the  default 
data  set  names  tor  the  Multics  installation  is  given. 

SHORT,  LONG  Default:  SHORT 

If  SHORT  is  given,  only  the  parameters  for  the  given 

command  are  printed.  If  LONG  is  qiven,  explanations 
of  the  various  parameters  are  also  printed. 

Examples:  HELP  FPS  LONG 

HELP  FILES  SHORT 


» This  command  has  been  improved  and  expanded  for  the  Multics 
installation;  hence  the  description  is  included  in  this 
appendix. 
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Command:  MTS 

Purpose:  To  execute  a Multics  command (s)  and  return  control  to 

the  Analyzer. 

Prototype:  MTS  Multics-command 
Parameters : 

Multics-command  line 

Only  the  Multics-command  line  is  executed  and  then 
control  is  returned  to  UR A.  All  Multics  conventions 
apply  to  this  command  line.  Multiple  commands  must 
be  separated  by  comas.  User  abbreviations  are 
permitted.  Any  Multics  command  is  allowed. 

Examples:  MTS  LIST  * . UF ATEM  P - BR  - NHE  ; PWD 

MTS  QETX 


Notes  for  running  under  Multics: 

For  any  single  terminal  session  under  Multics,  the  MTS 
command  has  the  effect  of  exiting  from  the  Analyzer  and 
issuinq  the  Multics  command.  This  differs  from  the  STOP 
command  as  the  STOP  terminates  the  UFA  session,  and 
requires  the  exec-con  command  to  return  to  UFA  mode.  Not 
only  does  the  MTS  command  save  money  (UFA  is  not 
terminated) , but  it  also  retains  the  parameters  set  in  the 
SET  command  and  contents  of  the  NAME- GEN  default  file,  etc. 
A STOP  would  require  that  these  parameters  be  restated. 

The  Multics  change- working-directory  (cwd)  command  must  be 
used  with  caution.  The  Analyzer  must  always  be  running 
from  the  working  directory  in  which  it  was  initially 
invoked.  The  user  must  not  perform  any  exec_com  command 
that  will  alter  the  I/O  attach  units. 


Appendix  E Using  the  UFA  Command  Language  with  Multics 


Command : 
Purpose: 
Prototype: 
Parameters 


I 


r’-'XU: . ' 


mmmm* 


UFA  User’s  Manual 


53* 


SET  Type:  control  command 

To  set  various  qlohal  switches  and  parameters. 

SET  [parameter]... 


DATA- BASE  (DB) =dataset- name  Default:  ura 

The  data  base  is  the  file  in  which  the  data  base 
information  is  assembled  and  stored.  This  facility 
allows  the  user  to  change  the  data  base  beinq  used  in 
the  middle  of  an  Anaylzer  session.  The  suffix  . dbf 
should  not  be  given.  The  full  relative  or  absolute 
pathname  should  be  used.  No  abbreviations  are 
recogn ized. 

FCHO  (E)  - (ON)  Default:  ECHO=OFF 

{OFF} 

with  "ECHO"  set  equal  to  ON,  the  commands  are  printed 
on  the  current  output  device  as  they  are  encountered. 
This  is  more  desirable  in  batch  (command  is  printed 
on  line  printer)  than  in  on-line  mode  (the  command  is 
echoed  back  at  the  terminal)  . 

HEADING  (H)  = ION)  Default  HEADING=CN 

(OFF) 

With  "HEADING"  set  OFF,  printing  of  headings  (date, 
title,  page  number,  etc.)  of  each  report  will  be 
suppressed.  Headings  will  be  printed  when  the  switch 
is  set  ON. 

LINES  (L)  =integer  Default:  LINF:S  = 46 

The  number  of  lines  printed  per  report  page  is  set  to 
the  indicated  number.  The  default  number  fits  the 
output  to  an  8-1/2  x 11  inch  page  for  convenient 
binding.  "LINF.S"  may  take  on  any  value  between  IT 
and  500. 

KO DS=  (BATCH  (B) ) Default:  mode  = termina 1 

(TFFMINAl  (1)  } 


This  switch  sets  other  switches  particular  to  the 
mode  of  operation  such  as  "prompt"  and  "echo", 

OUTPUT (0) 3dataset-name  Default:  term 

This  parameter  specifies  the  data  set  into  which  all 
subsequent  UFA  reports  are  written.  If  no  OUTPUT 
file  is  specified,  all  output  is  written  or.  the 
terminal  data  set. 
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xamples: 


PAR AMETERS (PARM) = {ON } Default:  ON 

(OFF) 

With  "PARAMETERS"  set  OFF,  the  printing  of  the 
parameters  in  effect  for  the  production  of  each  'JRA 
report  will  he  suppressed.  Parameters  will  be 
printed  when  the  switch  is  set  ON. 

PROBLEM- NAME  (PNAM) =user-name  Default:  Air  Force 

ESD/EADC 

Multics 

The  "PROELEM-NAME"  is  the  title  that  qoes  on  each 
page  of  the  output.  It  must  be  a UFL  name,  that  is, 
it.  must  begin  with  a code  3 character,  be  no  more 
than  30  characters  in  length,  and  be  composed  of  code 
3 and  4 characters  with  no  intervening  blanks. 

PROMPT  (P) * (ON)  Default:  PROMPT=ON 

{OFF} 

If  "PROMPT"  is  set  to  ON,  Ur  A will  prompt  the  user 
for  the  correct  command  or  parameters  when  an  error 
is  encountered.  With  "PPOKPT"  set  to  OFF,  URA  will 
ignore  invalid  commands  and  parameters  and  proceed  to 
the  next  command  or  parameter. 

SET  DB=WP74  PNA«=H.P.74  EXAMPLE  0=PRINT.FILE 


P 
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Command:  STOP  Type:  control  command 

Purpose:  To  terminate  execution  of  the  UFA  software  and  return 

control  to  Multics.* 


Prototype:  STOP 
Parameters: 

None 

Example:  STOP 


* Issuing  this  command  returns  all  storaqe  used  by  URA  for 
tables,  buffers,  parameters,  scratch  files,  etc.  All  files 
having  the  suffix  .uratemp  are  deleted.  To  restart  execution  of 
URA  the  user  must  give  the  Nultics  command: 

exec_com  >ml>CARA>ura 

If  the  user  interrupts  (breaks)  OTA  mode  or  enters  Multics 
command  mode  without  the  use  of  the  "STOP"  command,  the  user 
should  issue  the  Multics  "start"  command  to  return  to  UFA. 


% 
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2.  Data  £et  MlAHil  Conventions  for  JJ£A  in  Huliics 


2. 1 Naming  the  Data  gase  File 

The  user  need  not  commit,  to  memory  the  several  files  associated 
with  each  data  base,  the  tables  and  index,  nor  the  suffix  on  the 
names  of  each  file.  The  data  base  name  is  the  name  that  the 
user  wishes  to  use  to  refer  to  his  data  base.  The  Analyzer  will 
attach  any  necessary  suffix  to  refer  to  actual  Multics  segments. 
The  data  base  may  have  any  valid  Multics  segment  name. 


2.2  Naming  Igmgoran  £gta  Sets 

All  temporary  files  maintained  by  the  Analyzer  have  the  suffix 
.uratemp  attached  to  their  name.  When  the  Analyzer  is 
terminated,  two-component  seqments  with  .uratemp  as  the  suffix 
are  deleted.  Some  PUNCH  files  are  considered  to  be  temporary 
unless  the  user  supplies  a name  with  a different  suffix  (see 
section  4). 

Example: 

The  commands: 

NAKE-GEN  PUNC11*KY PUNCH  S*"ALL" 

NAKE-GEN  PUNCH=KY PUNCH . UF AT£H P S*"AIL" 

cause  names  to  be  written  in  the  data  set  KYPUNCH  and  to 
MY  PUNCH. UP A TEMP  respectively.  The  latter  data  set  will  he 
deleted  at  the  end  of  the  session. 


3. 


Jiates 


yPA  under  Multics 


When  creating  a data  base,  executing  the  Analyzer,  running  UFA 
utilities,  or  usinq  the  specification  generator,  your  Multics 
search  rules  must  have  >ml>CAPA  in  its  list.  This  can  be 
effected  with  the  following  command: 

asr  >ml >CAR A 


3.  i siaasina  and  uutialiiiiis  uu  d ases 

Before  the  user  can  add  information  to  a UFA  data  base,  the  data 
base  must  exist  and  be  initialized  properly.  Creating  an 
initialized  data  base  in  the  user's  working  directory  is  a 
simple  one-step  process.  The  user  should  type: 

ec  >ml>CAFA>initdb  (name)  (size) 


Appendix  E Usinq  the  UFA  Command  Language  with  Multics 


UFA  User‘s  Manual 


543 


* 


The  size  parameter  is  optional  and,  if  given#  should  be  the 
desired  size  of  the  data  base#  chosen  from  those  sizes  presently 
available  (i .e. # 20#  50,  1c0,  130).  The  default  size  if  not 
given  is  20.  The  name  parameter  is  also  optional  and#  if  given# 
is  the  name  that  UFA  will  use  to  reference  the  data  base.  Note# 
a suffix  of  .dbf  should  not  be  given  by  the  user.  The  default 
name  used  if  name  is  not  given  is  “ura.“  If  the  size  paraaeter 
is  to  be  used#  then  t.he  name  must  also  be  given. 


3.2  £jcecutjna  tjie  Analyzer  under  jjulti£s 

To  initialize  the  Analyzer  and  enter  UFA  node#  the  following 
command  should  be  given: 

> 

ec  >»l>CAPA>ura 

The  Analyzer  will  respond  “Enter  command  (and  any  parameters)  “ 
when  it  is  ready  to  accept,  each  command.  Ignore  any  “No  I/O 
switch"  messages. 

If  the  user  issues  an  interrupt  to  the  Analyzer#  then  the 
execution  may  be  resumed  at  tne  point  of  interruption  by  issuing 
the  command: 


start 

The  user  should  not  interrupt  the  Analyzer  during  a data  base 
update  or  modification  command  as  this  could  leave  the  data  base 
in  an  inconsistent  state. 

If  the  user  interrupts  the  Analyzer  during  a report  command  or 
while  UFA  is  idle  and  wishes  to  prematurely  terminate  the 
Analyzer  and  begin  again#  the  Multics  commands  are: 

close  file  -all 
release  -all 
closeit 

The  user  must  use  the  SFT  command  to  reset  any  parameters  for 
each  Analyzer  session. 
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Example  UFA 

loain  Use tin 

password 

ec  >«l>CAPA>initdb  aydb 

ec  >ml>CAFA>ura 

set  db=aydb  o-temp. print 

input-psl  i nput=afile. url  update 

mts  print  temp. print 
listing  stored  m sequent 

name-qen  ss’all* 

f ps 

stop 

dprint  temp. print 
loqout 


sessions 

Ll22lD  ilujtjcsj 

[user  password  to  Multics] 

[create  and  initialize  an 
empty  data  base] 

[enter  UFA  mode] 

[set  control  information] 

[update  UFA  data  base 
using  contents  of 
afile.url  in  current 
working  directory] 

[looks  at  as-is  source 

[get  list  of  all  names] 

[get  FPS  for  all  names] 

[leave  UFA  mode] 

[print  output  - line 
printer  ] 

[logout  of  Multics] 


temp. print  ] 
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A subsequent  session  may  enter  more  input  and  generate  some 
reports. 


login  Osegid 

password 

ec  >ml>CAFA>ura 

set  db=mydb  pnam=Multics-example 
input-psl  in put=soaef ile. ur 1 update 

name-gen  s='process' 
picture 

name-gen  s-'all' 

f ps 

stop 

logout 


Lloglg  IS  flgltjcsj 

[user  password  to  Multics] 

[enter  UFA  mode] 

[set  control  information] 

[ update  the  data  base 
using  the  contents  of 
somef ile. ur 1 ] 

[get  list  of  process 
names  ] 

[ get  Picture  report  for 
each  process  name] 

[get  list  of  all  names] 

[get  FPS  for  all  names] 

[leave  URA  mode] 

[logout  of  Multics] 
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Segment  Names 


Table  E.1  presents  a summary  of  flultics  default  segment  names  used 
in  conlunction  with  each  UFA  command.  The  "Default  Input  File" 
is  the  default  segmen*  used  as  input  to  the  command  if  no  other 
segment  set  has  been  specified  (i.e.,  via,  the  "INPUT="  or 
"FILS*"  parameter.)  A dash  in  the  entry  designates  that  the 
command  has  no  Input  data  parameters. 

The  "Default  PUNCH  File"  is  the  default  segment  used  to  store 
PUNCH  data  from  the  command  if  no  PUNCH  segment  is  designated 
via  the  "PUNCH*"  parameter.  A dash  in  the  entry  designates  that 
no  PUNCH  data  can  be  obtained  directly  from  the  command.  (PUNCH 
data  is  data  that  is  directly  acceptable  as  input  to  a UFA 
command . ) 
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Multics  Default  *>eqoient  Names 


Command 
CHANGE-TYPE 
CONSISTS- COMPARISON 
CONSISTS-MATFIX 
CONTENTS 
DATA-PKOCESS 
DELETE 

DELETE-COMMENT- ENTRY 

DELETE- PSL 

DICTION  AF  Y 

DYNAMIC-ANALYSIS 

ENTITY-IDENTIFIER 

EXTFNDED- PICTURE 

FORM  ATT ED-PF03 LEM- STATEMEN 

FREQUENCY 

IN  PUT-PSL 

INTERVAL-CONSISTENCY 

KWIC 

LIST-CHANGE 

NAME-GEN 

NAME-LIST 

PICTURE 

PRINT- ATTRIBUTE- VALUES 
PROCESS-CHAIN 
PROCESS- INPUT- OUT PUT 
PROJECT ED-COST- ?E PORT 


Defau 3 1 Input  File 
uraname.uratemp 
uraname.uratemp 
uraname.uratemp 
uraname.uLatemp 
uraname.uratemp 
uraname. uratemp 
uraname.uratemp 
term 

uraname.uratemp 
uraname. uratemp 
uraname.uratemp 
uraname.uratemp 
uraname.uratemp 

term 

rename. ur  at  emp 
uraname.uratemp 


Default  PUN£H  Fi  le 


PUNCH-COMMENT- ENTFY 
RENAME 

REPLACF.-COMMENT-ENTFY 
RE SOURCE- CON SUMPTION- AN 
SECURITY- ANALYSIS 
STRUCTURE 
SUMMAFY 


uraf ps. url 


term 

• •• 

uraname.uratemp 
uraname.uratemp 
uraname.uratemp 
uraname.uratemp 
FILE=uraname.  ura  temp 


uraname. uratemp 


uraname. uratemp 


INPtJT*term 
uraname.uratemp 
no  default 
urapeom. comment 
ALYSIS  uraname.uratemp 
uraname ,ur  atem p 


term 

ura  pcom. comment 


TABLF  F . 1 
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I 


code  3 character 

data  set 

exec_com  segment 

file 

multi-segment  file 
pathname  (absolute) 

pathname  (relative) 

quit  siqnal 

segment 

UFA  session 

working  directory 


MULTICS  GLCSSAFY 


A character  allowed  in  any  position  ir.  a 
IJFL  name.  See  Appendix  B. 

A synonym  for  segment. 

A segment  with  a '.ec'  suffix  which 
contains  Multics  commands.  These 
commands  may  be  initiated  by  the  command: 
exec_co»  segment^ name 

where  the  segment  name  does  not  need  to 
have  the  suffix  appended. 

A segment  or  multi-segment  file. 

A file  composed  of  multiple  paqe  units. 

The  connotation  of  a segment's  entry-name 
with  all  superior  directories  leading 
hack  to  the  storage  system  root. 

The  pathname  that  uniquely  names  a 
segment  relative  to  the  working 
directory. 

The  means  by  which  users  may  interrupt 
Multics  from  processing  a program  or 
command  lines. 

Ihe  basic  unit  of  information  within  the 
Multics  storage  system.  Each  segment  has 
access  attributes  and  a name,  and  may 
contain  data,  proqrams,  or  be  null. 

An  interactive  session  between  the 
Multics  command  "ec  >m l>CARA>ura"  and  the 
UFA  command  "stop." 

’’"he  directory  under  which  the  user  is 
doing  his  work. 
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Appendix  F 

EXAMPLE  OF  DOCUMENT  SCHEMA  AND  SOUFCE 
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This  appendix  consists  of  two  examples,  a Fuctional 
Description  and  a Data  Requirements  Document.  Fach  example 
consists  of  a schema  and  a correspondinq  source.  The  examples 
are  presented  in  the  following  order: 

Schema  for  the  Functional  Description 

Source  for  the  Functional  Description 

Schema  for  the  Data  Requirements 

Source  for  the  Data  Requirements 
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1 ♦TITLE  FUNCTIONAL  DESCRIPTION 

2 ♦HEADING -KARGIN  3 

3 #1.  FUNCTIONAL  DESCRIPTION  - GENERAL 

4 & THIS  IS  AN  EXAMPLE  DOCUMENTATION  SCHEMA  OF  THE  FUNCTIONAL 

5 5 DESCRIPTION  FOUND  IN  DOD  MANUAL  4 12C.17-K. 

6 *1.1  PUFPOSE  OF  FUNCTIONAL  DESCRIPTION 

7 #1.2  PROJECT  REFERENCES 

8 #2.  SYSTEM  SUM MAI Y 

9 #2.1  BACKGROUND/PUP POSFS 

10  #2.2  OBJECTIVES 

11  *2.3  EXISTING  METHODS  AND  PPOCFDDRES 

12  #2.4  PROPOSED  METHODS  AND  PROCEDURES 

13  #2.4.1  SUMMARY  OF  IMPROVEMENTS 

14  #2.4.2  SUMMARY  OF  IMPACTS 
13  #2.4.2. 1 EQUIPMENT  IMPACTS 

16  #2.4. 2. 2 SOFTWARE  IMPACTS 

17  #2. 4. 2.  3 ORGAN  17  ATIONAL  IMPACTS 

18  #2. 4. 2. 4 OPERATIONAL  IMPACTS 

19  #2. 4. 2. c DEVELOPMENT  IMPACTS 

20  #2.5  FXPECTED  LIMITATIONS 

21  #3.  DETAILED  CHARACTERISTICS 

22  #3.1  SPECIFIC  PERFORMANCE  REQUIREMENTS 

23  #3.1.1  ACCURACY  AND  VALIDITY 

24  #3.1.2  TIMING 

25  *3.2  SYSTEMS  FUNCTIONS 

26  #3.3  TV  PUTS/OUT  PUTS 

27  #3.4  iMTA  CHARACTERISTICS 

28  #3.5  FAILURE  CONTINGENCIES 

29  #4.  ENVIRONMENT 

30  *4.1  EQUIPMENT  ENVIRONMENT 

31  #4.2  SUPPORT  SOFTWARE  ENVIRONMENT 

32  *4.3  INTERFACES 

33  #4. 4 SECURITY 

34  #5.  COST  FACTORS 

35  #6.  DEVELOPMENT  PLAN 


t 


1 
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1 #1.  FUNCTIONAL  DESCRIPTION 

2 tSET  DF'SPGEX 

3 *HFADING-SKIP  3 

4 ♦TOP-LINFS  2 

5 * BOTTOM- LINES  2 

f & THIS  IS  AN  EXAMPLE  DOCUMENTATION  SOURCE  OF  THE  FUKCTIOKAI 
7 & DESCRIPTION  STANDARDS  FOUND  IN  DOD  MANUAL  412C.17-M. 

6 F,  IT  IS  WRITTEN  IN  CONJUNCTION  THE  EXAMPLE  DATA  BASS  FOUND 
9 8 IN  IS  DOS  WP  74. 

10  *SKIP  1 

11  #1.1  PURPOSE  OF  FUNCTIONAL  DESCRIPTION 

12  *SKIP  1 

13  THIS  FUNCTIONAL  DESCRIPTION  FOR  Til  E PA YSTATEMRNT  EXAMPLE, 
PROJECT  #1 

14  IS  WRITTEN  TO  PROVIDE: 

13  A.  THE  SYSTEM  REQUIREMENTS  TO  BE  SATISFIED  WHICH  WILL  SFRVS 
AS  A 

lb  BASIS  FOF  MUTUAL  UNDERSTANDING  PFTWEFN  THE  USER  AND  THF 
DEV  ELOPFF . 

17  B.  INFORMATION  ON  PERFORM ANCF  P EQIIIF EM  ENTS , PRELIMINARY 
DESIGN,  AND 

IP  USEF  IMPACTS,  INCLUDING  FIXED  AND  CONTINUING  COSTS. 

19  C.  A BASIS  FOR  THE  DEVELOPMENT  Of  SYSTEM  TESTS. 

20  #1.2  PROJECT  REFERENCES 

21  *SK IP  1 

2.2  THE  PAYROLL  DEPARTMENT  IS  THE  SPONSOF  AND  USER  OF  THIS 
MANAGEMENT 

23  INFORMATION  SYSTEM.  THE  ACTUAL  OPERATION  OF  THIS  SYSTEM 
WILL  BF. 

24  HANDLED  PY  BOTH  THE  PAYROLL  DEPARTMENT  AND  THE  DATA 
PROCESSING 

25  DEPARTMENT. 

26  *SKIP  1 

27  A.  A COPY  OF  THE  PROJECT  FFQUFST  IS  IN  THE  APPENDIX. 

2P  B.  STANDARDS  AND  FEFFERFNCE  DOCUMENTATION 

2«  1.ISDOS  WORKING  PAPERS  74,86,90 

3*‘  2.  DOD  ADS  DOCUMENTATION  STANDARDS  MANUAL  4120. 1 7- M 

31  *HFADING-SKIP  61 

32  #2.  SYSTEM  SUMMARY 

33  *SKIP  1 

34  THIS  SECTION  SHALL  PROVIDE  A GFNERAL  DESCFIPTION,  WRITTEN  IN 

35  NON-ADP  TERMINOLOGY,  OF  THE  TPOPOSED  ADS. 

36  *HSADING-SKIP  3 

37  #2.1  BACKGROUND/PURFOSES 

38  *SK IP  1 

3-3  %FCOM  N *BACKGFOUNP-MENo  TFSC  NOPUNC1I 
4 C #2.2  OBJECTIVES 

41  *5KIP  1 

42  fPCOM  N 'OBJECT IVES- MEMO  DESC  NOPUNCH 

43  #2.3  EXISTING  METHODS  AND  PROCEDURES 

44  *S K I P 1 

45  SINCE  THIS  IS  A NEW  COMPANY,  THERE  IS  NC  APPLICABLE  EXISTING 

4 6 PROCEDURE  FOR  DCING  THF  PAYROLL. 

47  #2.4  PFOPOSRD  MFTHODS  AND  PFCCFDURFS 
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48  *SKIP  1 

49  *PCOM  N = PROCESS- M E MO  DESC  NOPUNCH 

50  *0010  43 

51  <PIC  N=MAIN-PFOCESS  NC  STR  UCTUF  E 
^2  ♦HEADING-SKIP  2 

53  #2.4.1  SUMMARY  OF  IMPROVEMENTS 

54  ♦ SKIP  1 

55  A.  STAFFING 

56  ♦ SKIP  1 

57  *PCOM  N = PA YFOLL- DE  PT- £M  PLO YF  * $ PFSC  NOPUNCH 

58  *SKIP  1 

5Q  B.  TIMELINESS 

60  *SKIP  1 

61  *FPS  NLNS  NPEOF  N =0N E 

62  #2.4.2  SUMMARY  OF  IMPACTS 

63  *SK  IP  1 

64  *2.4. 2.1  EQUIPMENT  IMPACTS 

65  *SKIP  1 

66  A LINE  PFINTEF  CAPABLE  OF  PFINTING  CHECKS  IS  NECESSARY. 

67  EQUIPMENT  CAPABILITIES  ARE  DISCUSSED  IN  PARAGRAPH  4.1. 

68  #2.4.2. 7 SOFTWAFE  IMPACTS 

69  ♦SKIP  1 

7 C THERE  AFF  FIVE  BASIC  SOFTWARE  AFEAS  WITHIN  THL  PAYROLL 
SYSTEM. 

71  *SKIP  1 

12  ANG  S = ' SO  = MAIN-PPOCESS,  1 • 

73  ♦ HOLD  43 

74  fPIC  N = M AI N- PPOCpSS  NODATA  NOFLCW 

75  #2.4. 2. 3 ORGANIZATIONAL  IMPACTS 

76  *SK IP  1 

77  <FPS  NLNS  NPEOF  N=?ESPONSIBII ITIES 

78  *HEADING-SKIP  5C 

79  #2.4.2. 4 OPERATIONAL  IMPACTS 

8 0 ♦HEADING-SKIP  2 

81  ♦FEPOFT-CC  OFF 
92  ♦SKIP  1 

83  A.  OPEF  AT ION  A L STRUCTURE 

84  *STR  PROCESS 

85  *NEW-PAGE 

86  B.  TIMELINESS  (OPERATIONS  AND  DMA) 

87  ♦SKIP  1 

88  HERE  IS  A SUMMAFY  OF  FFEQUENCY  DATA. 

89  * S K I P 1 

9C  ING  S*' TNTEF  VAL ' NOPFINT 

91  iFF EQ  ORDER  =BYTYPE  INTERVAL 

92  ♦NEW-PAGE 

93  C.  INPUTS 

94  *STR  INPUT 

95  ♦SKIP  2 

96  D.  DATA  RETENTION 

97  ♦SKIP  1 

98  %PCOK  N *NA  STEF- FILE  DESC  Dr?  NOTUNCH 

99  ♦HOLD  43 

ir ( tPIC  N = MASTFF,-F1LE  NOPATA  NOFI.CW 
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V 1 *HSADING-SKIP  59 

1C  2 #2. 4. 2. 5 DEVELOPMENT  IMPACTS 

It  3 *FFPOFT-CC  ON 

104  *SKIP  1 

It.  5 AFPS  NLNS  NPEOF  N ^COMPLEXITY- LE VFL 
It-  6 *SKIP  2 

11*  7 *FP5  NLNS  NPEOF  N= DEVELOPMENT- NEEDS 

1 9 *HSADING-SKIP  3 

1C  9 #2.5  EXPECTED  LIHI T A TIC N S 

110  *SKIP  1 

111  EEFORS  WILL  PE  NECESSARY  FOF  BAD  DATA  INPUT 
111  *SKIP  1 

11?  VPCOil  N=EF. FOP-LISTING  DESC  NOPUNCH 
114  *HOLD  4? 

113  APIC  N = ERR  01 -LI STING 

116  * HOLD  43 

117  *PIC  N= ERR OR- LISTING- ENTRY 

118  *HEADING-SKIP  59 

119  #3.  DETAILED  CHARACTERISTICS 

120  *HEADING-SKIP  3 

121  *SKIP  1 

122  #3.1  SPECIFIC  PERFORMANCE  SEQUIF EM ENTS 

123  *SKIP  1 

124  (SEE  SECTION  2) 

125  *SKIP  1 

126  %FPS  NLNS  NPEOF  N*PAYROLL“ PFOCESSING 

127  *SK IP  2 

128  DATA  RECEIVED: 

129  *NG  S^'INPUT  OF  SET'  OFDEF*DYTYPE 

130  *SKIP  2 

131  OUTPUTS  GENERATED: 

132  *SKIP  2 

132  tNG  Ss' OUTPUT' 

134  #3.1.1  ACCURACY  AND  VALIDITY 

135  *SK IP  1 

136  APCOM  N= AC CURACY- MEMO  DESC  NCFUNCH 

137  *SKIP  2 

138  %FPS  NLNS  NPEOF  N=VALIDITY- CHECK 

139  *HOLD  43 

14C  *PIC  N=HOUPLY- PAYCHECK- VALIDATION 

141  *N  EH- PAGE 

142  *PIC  N=SALARIED-PAYCHECK-VALirA'rICN 

143  #3. 1. 2 TIMING 

144  *SKIP  1 

145  THE  FOLLOWING  IS  A DESCRIPTION  OF  THE  FUNCTIONAL  FLOW. 

146  *SKIP  1 

147  FOF  SALARIED  EMPLOYEES  - 

148  *SKIP  1 

149  *FPS  NLNS  NPEOF  N = S ALAR  I ED- EKP- PFOCESSI NG-I NIT 

130  tFPS  NLNS  NPEOF  N= VALIDITY-CHECK 

131  AFPS  NLNS  NPEOF  N *P ASSED- EFPOR-CHZCKS 

132  tPPS  NLNS  NPEOF  N = S ALAR  I ED- PAYCHECK-PFOD- IN  IT 

133  *SKIP  2 

134  FOF  HOURLY  FMPLCYSES  - 
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V 


* 


% 


135 

136 

137 

138 

139 
160 
161 
162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 
181 
182 

183 

184 

185 

186 

187 

188 
189 
199 

191 

192 

193 

194 
1Q5 

196 

197 

198 

199 

200 
2C1 
29  2 
2C  3 
2C  4 
20  5 
2*' 6 
2°  7 
2.8 


♦SKIP  1 

«FPS  NLNS  NPEOF  N «HOURL Y-EMP- PROCESSING-1  NIT 

XFPS  NLNS  NPEOF  N= VALIDITY- CHECK 

*FPS  NLNS  NPEOF  N =TIME-CARD-MISSING 

*FPS  NLNS  NPEOF  N*P ASSED-ERFOB-CHSCKS 

*FPS  NLNS  NPEOF  N»HOUBLY-PAYCHECK-PF.OD-INIT 

tFPS  NLNS  NPEOF  N=NSW-EMPLOYEE-PROCESSING-INIT 

*FPS  NLNS  NPEOF  N*IE3MINATION-FPOCESSING-INIT 

♦HEADING-SKIP  59 

*3.2  SYSTEM  FUNCTIONS 

♦HEADING-SKIP  3 

♦BEPOPT-CC  OFF 

♦SKIP  1 

SNG  S=' SO=MAIN-PROCESS,1 • NOPPINT 
♦SKIP  1 

THE  VARIOUS  SUB- FUNCTIONS  OF  THE  SYSTEM  ARE: 
♦SKIP  1 


<PCOM  DESC  PRCD  NOPUNCH 
*3.3  INPUTS/OUTPUTS 
♦SKIP  1 
INPUTS: 

♦SKIP  1 

UNG  S-' INPUT • NCPBINT 
^FPS  NLNS  NPEOF 
♦SKIP  2 
OUTPUTS: 

♦SKIP  1 

<NG  S*' OUTPUT ' NOPRINT 
?FPS  NLNS  NPEOF 
♦SKIP  2 
^STP  OUTPUT 

*3.4  DATA  CHARACTERISTICS 
♦ PSPORT-CC  ON 


♦SKIP  1 


<F?S  NLNS  NPEOF  N»? AYBOLL-MASTER-IN FORMATION 
♦SKI?  2 

S THE  FOLLOWING  LINES  ARE  EXCLUSIVE  TO  THIS  DOCUMENT 
*PCOM  N ^DEPARTMENT- FILE  DESC  DER  VCLS  NCPUNCH 


♦SKIP  1 

*PCOM  N= HOURLY- EMPLOYE 2- FILE  DESC  DER  VOLM  NCPUNCH 
♦HOLD  43 

tPIC  N* HOURLY- EMPLOYEE- FILE 


* NE  W- PAGE 

IPCOM  N* SAL ARISE- EM PLOY EE- FILE  DESC  DER  VOLM  NOPUNCH 
♦HOLD  43 

*PIC  N* SALARIED- EMPLOYEE- FILE 
*3.5  FAILURE  CHARACTERISTICS 
♦SKIP  1 

1PCOM  N * BACKUP- MEMO  DESC  NOPUNCH 
♦HEADING-SKIP  61 
*4.  ENVIRONMENT 
♦HEADING-SKI?  3 
♦SKIP  1 

*4.1  EQUIPMENT  ENVIRONMENT 
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209  *SKI?  1 

210  *FCOM  N "EQUIPMENT- MEMO  DSSC  NOPUNCH 

211  *4.2  SUPPORT  SOFTWARE  ENVIRONMENT 

212  *SKIP  2 

213  1PCOM  N"  SO  FT  WARE- MEMO  DESC  NOPUNCH 

214  #4.3  INTERFACES 
213  *SKIP  1 

216  tSTR  RWE 

217  *HOLD  43 

218  *PIC  N*ACCOUNTING-SYSTEMS 

219  *NEW-PAGE 

220  <PIC  N*PAYROLL- DEPARTMENT  * 

221  #4.4  SECURITY 

222  *FEP05T-CC  OFF 

223  •SKIP  1 

224  tPCOM  N«SECURITY-HEMO  DESC  NCPUNCH 

225  *NG  S* ' SEC USITY ’ NOPBINT 
22o  %FPS  NLNS  NPEOF 

227  *HEADIN G-SKIP  61 

228  #5.  COST  FACTORS 

229  *PCOM  N*COSTS-M2MO  DESC  NOPUNCH 

230  #6.  DEVELOPMENT  PLAN 

231  *SKIP  1 

232  tPCOM  N*D2V0LPMENT-aEaC  DESC  NOPtlNCH 

233  *SKIP  2 

234  *FPS  NLNS  NPEOF  N* DEVSLC PSENT- TIMES 


t 

I 
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! 

i 

! 

1 *TITLE  DATA  REQUIREMENTS  DOCUMENT 

2 *HEA DING- MARGIN  3 

3 *LINES  50 

U #1.  GENERAL  DATA  REQUIREMENTS 

5 6 THIS  IS  AN  EXAMPLE  DOCUMENTATION  SCHEM  OF  THE  DATA 

6 S REQUIREMENTS  DOCUMENT  FOUND  IN  DOD  MANUAL  4120. 17-M 

7 #1.1  PUPPOSE  OF  DATA  REQUIREMENTS 

8 #1.2  PROJECT  REFERENCES 

9 #1.3  MODIFICATION  OF  DATA  REQUIREMENTS 

10  #2.  DATA  DESCRIPTION 

11  #2.1  LOGICAL  ORGANIZATION  OF  STATIC  SYSTEM  DATA 

12  #2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

13  #2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

14  #2.4  INTERNALLY  GENERATED  DATA 
13  #2.5  SYSTEM  DATA  CONSTRAINTS 

16  #3.  USER  SUPPOFT  FOR  DATA  COLLECTION 

17  #3.1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 
ie  #3.2  RECOMMEND  SOURCE  OF  INPUT  DATA 

19  #3.3  DATA  COLLECTION  AND  TRANSFER  PROCEDURES 

20  #3.4  DATA  BASE  IMPACTS 


I 
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1 #1.  GENERAL  DATA  REQUIREMENTS 

2 6 THIS  IS  AN  EXAMPLE  DOCUMENTATION  SOURCE  OF  THL  DATA 

3 S REQUIREMENTS  DOCUMENT  FOUND  IN  DOD  MANUAL  4120. 17-M 

4 #1.1  PURPOSE  OF  DATA  REQUIREMENTS 

5 *SICIP  1 

6 *SOURCE“ MARGIN  1 

7 THE  OBJECTIVES  OF  THIS  DATA  REQUIREMENTS  DOCUMENT  FOF  THF 

8 PAY  STATEMENT  EXAMPLE,  PROJECT  #1  APE  TO  LIST  AND  DEFINE  DATA 

9 ELEMENTS  WHICH  THE  SYSTEM  MUST  HANDLE  AND  COMMUNICATE  DATA 
1C  COLLECTION  FFQUIREM ENTS  TO  THE  USER. 

11  #1.2  PROJECT  REFERENCES 

12  *SKIP  1 

13  *SET  DB*SPGEX 

14  tPCOM  N *OBJECII  VES**MSMO  DESC  NOPUNCH 
13  *SKIP  1 

16  VPCOM  N= PAYROLL* DEPARTMENT  DESC  NOPUNCH 

17  #1.3  MODIFICATION  OF  DATA  REQUIREMENTS 

18  *SKIP  1 

19  NOT  APPLICABLE  TO  THIS  PROJECT. 

2C  *HEADING-SKIP  61 

21  #2.  DATA  DESCRIPTICN 

22  *SKIP  1 

23  *SOURCE-KARGIN  5 

24  *HEA DING- SKIP  2 

25  THE  DATA  DESCRIBED  IN  THIS  SECTION  SHALL  BE  SEPEFATED  IN"C 
TWO 

26  CATEGORIES,  STATIC  DATA  AND  DYNAMIC  DATA.  STATIC  DATA  IS 
DEFINFD 

71  AS  THAT  DATA  WHICH  IS  USED  KAINIY  FOR  REFER ENCL  LUFING 
SYSTEM  OP- 

28  EPATION  AND  IS  USUALLY  GENERATED  CF  UPDATED  IN  WIDELY 
SEPERATED 

29  TIME  FRAMES  INDEPENDENT  OF  NORMAL  SYSTEM  FUNS.  DYNAMIC  DATA 
IN- 

30  CLUDES  ALL  DATA  WHICH  IS  INTFNDED  TO  BE  UPDATED  AND  WHICH  IS 

31  INPUT  TO  A SYSTEM  DURING  A NOFMAL  RUN  (INCLUDING  "REAL  TIKE" 
DATA 

32  SUCH  AS  TARGETING  DATA)  OR  IS  OUTPUT  BY  THF  SYSTEM.  STATIC 

DATA 

3?  AS  DESCRIBED  ABOVE  IS  FREQUENTLY  FEFEFRED  TO  AS  PARAMETRIC 

DATA 

*4  AND  DYNAMIC  DATA  AS  NON-PAR AMETFIC  DATA.  BOTH,  HCWEVEF,  ARE 
COM- 

35  POSED  OF  DATA  FLEMENTS.  THE  DATA  ELLMFNT  NAMES  LISTED  IN 

PAPA- 

30  GRAPHS  2. 1,2. 2,  .AND  2.3  SHALL  BE  THOSE  CONTAINED  IN  STANTARD 

37  DATA  ELEMENT  LIBRAPIES,  WHENEVER  APPLICABLE. 

38  #2.1  LOGICAL  ORGANIZATION  OF  STATIC  SYSTEM  DATA 
3Q  *SKIP  1 

4'.'  ^CONTENTS  N *M A STFF- FI LE 

41  *SKIP  1 

42  ^CONTENTS  N=DEPT-FILS 

43  *SKIP  1 

44  ^CONTENTS  N = H- EM P- FILE 
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45  *SK  IP  1 

46  ^CONTENTS  N=S-SMP-FILE 

47  #2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

48  *SKIP  1 

49  ♦REPOFT-CC  OFF 

50  tNG  S®' SO=EHP-INFO,  1 • NOPRINT 

51  ^CONTENTS 

52  #2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

53  *PSPOFT-CC  ON 

54  *SKIP  1 

55  ^CONTENTS  N=PA Y-STAT SMENT 

56  *SK  IP  1 

57  fCONTEN TS  N=HOUFLY-EMPLOYEE- FEPOFT 

58  *S  K IP  1 

59  ^CONTENTS  N = S AL ANI  ED-  EM. PLO YEF-  RFPOI-  T 

60  *SKTP  1 

61  ^CONTENTS  N=HIPED- EMPLOYEE- FEPOF? 

62  ♦SKIP  1 

63  ^CONTENTS  N=TE5MINATED- EMPLOYEE- F2PORT 

64  *2.4  INTERNALLY  GENERATED  DATA 

65  *SKIP  1 

66  ^CONTENTS  N=ERPCR- LISTING 

67  #2.5  SYSTEM  DATA  CONSTRAINTS 

68  *SK IP  1 

69  *FP3  N= I- 0- CONSTRAINTS- MEMO 

70  ♦HEADING-SKIP  61 

71  #3.  USER  SUPPORT  FOR  DATA  COLLFCTION 

72  ♦HEADING-SKIP  2 

73  <NG  S®' INPUT  OP  OUTPUT'  OFDEF®BYTYrE  NOPRINT 

74  XCNC 

75  ♦NEW-PAGE 

76  INFORMATION  IN  REGARDS  TO  DATA  FLOW 

77  *DP  D 

78  *NG  S= ' ENTITY ' NOPEINT 

79  ♦NEW-PAGE 

80  INFORMATION  ON  RECORDS  KEPT 

81  *CNC 

82  ♦HOLD  59 

83  #3.1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPF 

84  *SKIP  1 

h5  INFORMATION  NEEDED  IN  ORDER  TO  ESTABLISH  THE  VALUES 

86  OF  EACH  DATA  ELEMENT: 

87  *SKI P 2 

88  <FPS  N=SALARI2D- EMPLOYMENT- FORM 

89  %FPS  N= HOURLY- EMPLOYMENT -FORM 

90  *FPS  N=TAX- WITHHOLDING-CSPTIFICATS 

91  *FPS  N® EMPLOYMENT- TERMINATION- FORM 

92  *SKIP  2 

93  INFORMATION  TO  PS  COLLECTED  BY  THE  USFF : 

94  ♦SKIP  1 

95  *FPS  N=TIME-CARD 

96  *SKIP  2 

97  OTHER  SUPPLEMENTARY  INFORMATION: 

98  *SKIP  1 
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99 

mo 
ic  1 
10  2 
10  3 
104 
1C  5 
106 
1C 7 
1 08 

109 

110 
111 
112 

113 

114 
113 
116 

117 

118 

119 

120 
121 
122 

123 

124 

125 

126 

127 

128 
12° 
130 


A.  INPUT  SO  U ?C  F (5)  OF  Tilt  DATA  ELEMENT 
♦SKIP  1 

tFPS  N*DEPAPTM3NTS- AND- EMPLOYEES 
tFPS  N*  EM  PLOY EE 
tFPS  N=PAY ROLL- DEPARTMENT 
♦SKIP  2 

B.  RECIPIENTS 
♦SKIP  1 

tFPS  N* ACCOUNTING-S YSTFMS 
♦SKIP  2 

D.  CRITICAL  VALUES 
tFPS  N=REKAINING- FUNDS 
♦SKIP  2 

E.  OUTPUT  FOSM/DEVICE 
♦SKIP  1 

tPCOK  N -H-EMP-BEPORT  DESC  NOPUNCU 
♦SKIP  1 

XPCOK  N=S-EMP-PEPORT  DFSC  NOPUNCH 
♦SKIP  2 

F.  FREQUENCY  OF  UPDATE 
tFREQ 

#3.2  RECOMMENCED  SOURCE  OF  INPUT  DATA 

♦SKIP  1 

THIS  TOPIC  HAS  BEEN  DISCUSSED  APOVE  (SECTION  3.1. A) 
#3.3  DATA  COLLECTION  AND  TPAESFFR  PROCEDURES 
♦SKIP  1 

THIS  TOPIC  HAS  BEEN  DISCUSSED  APOVE  (SECTION  3.1.  F) 
#3.4  DATA  BASS  IMPACTS 
♦SKIP  1 

tPCOM  N*DEPAFTMENT-FII E DESC  DFF  VCLS  NOPUKCH 
tPCOM  N* HOURLY- EMPLOYEE- FILE  DFSC  Dt’F  VOLK  NOPUNCH 
tPCOM  N -SAL  AF I ED- EM  PLOY  EE- FILE  DESC  DEF  VCLK  NOPUNCH 
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This  appendix  contains  examples  of  the  Functional  Descciption 
Document  written  usinq  the  Automated  Oocuaentation  Systea.  The 
Analyser  data  base  used  is  the  Pay  Systea  exaaple  described  in 
Part  XV  of  this  aanual.  Due  to  space  limitations,  listings  of 
’'he  Analyzer  data  base  are  not  included. 

The  following  list  of  Analyzer  coaaands  have  been  used  to 
produce  these  exaaples: 

SgljUUi  HA££  liimfilSis  £2*3 

CONTFNTS  FILF 

NA-E 

DATA  PFOCFSS  DATA 

FILE 


FPS 


NAME 

FILE 

PFINT 


FREQUENCY 


NA^E-GEN  ENTITY 

INPUT 

OUTPUT 

PFINT 

NOPFINT 

SUBLEVEL 

SUBPAFT  OF 

SECUFITY 

PICTURF  DATA 

NCDATA 

FILE 

NAKF 

FLOW 

NOFLOW 

STFUCTUPF 

NCSTF  UCTUFE 

PUNCH-COMMLNT-FNTFY  DEF 

DESC 

PROC 

VOLM 

VOLS 

FILE 

NAME 


NOPUNCH 

PRINT 
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OUTPUT 

Although  these  Are  the  only  coaaands  used,  all  Analyzoi 
■ay  he  used  with  the  Automated  Document  at  ion  ftonoratoi 
exception  of  the  STOP  coaannd) . 


coKaands 
(with  the 
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Using  Multics,  the  Automated  Documentation  System  can  run  using 
the  following  command: 

exec-coa  >« 1>CAF A >UF A>spg  schema-segment  source-segment 

This  command  will  do  all  syntax  checking  retied  and  generate  the 
document.  Output  for  the  uocuaen*  will  go  to  the  tile 
spg. output.  The  system  assumes  the  Analyzer  data  base  is  in  the 
file  uradb.dbf  unless  the  StT  command  is  used  to  change  the 
default  (i.e.,  SF7  DB=£ile). 


Output  from  this  section  looks  as  follows: 


lins  HU  £ ecttou 


3 

u 

5 

6 
7 

a 

9 

*** 

10 

11 

12 

13 


5 o 

0 2 

0 1 

•KISSING* 


f. 

f,  A SMALL  TEST  EXAMPLE 

r, 

*1,  SCOPE 
*1.1  IDENTIFICATION 
*1.2  FUNCTIONAL  SUMMARY 
*1.3 
*1.*» 


INVALID  SECTION  IDENTIFIER 


f. 


l 0 *2.  APPLI CABLE  DOCUMENTS 

13  2 *2.1  GOVEE  NMFN1  POCUKFN1S 

5 1 *2.2  N'ON-GOVFPNKLNT  DOCUMENTS 


SUMMARY 

8 SECTIONS 

1 OF  WHICH  AFT  MISSING  FF OM  THE  SOURCE  FILE. 
18  TOTAL  TEST  LINES.  AND 
6 TOTAl  COMMAND  I.I NFS . 
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analyst 

Analyzer 
comment  entry 

comment  entry 
statement 

control 

commands 


conversational 

mode 


data  base 


data  object 

fdname 

f i loname 
input  file 

loqical 

description 

loqical  system 
design 


GLOSSARY 


Name  used  synonymously  for  "problem  definer." 
One  who  aids  to  develop  the  problem  statement 
or  loqical  system  design. 

Synonym  for  "UFA."  Is  the  software  package 
that  processes  problem  stated  in  the  Lanquaqe. 

The  text  associated  with  a comment  entry 
statement.  DESCRIPTION , PROCEDURE  and 
VOLATILITY  are  examples  of  statements  which  are 
specified  by  comment  entries. 

Any  URL  statement  in  which  the  contents  of  the 
statement  are  defined  by  the  problem  definer 
(as  is  narrative  description).  The  DESCRIPTION 
and  PFOCEDURE  statements  are  examples  of  this. 

Those  UFA  commands  which  allow  the  UFA  user  to 
pass  certain  control  information  to  the 
Analyzer.  They  are  particular  to  an  individual 
operating  system. 

Interactive  use  of  the  computer  system  through 
a terminal  device.  Used  synonymously  with 
on-line  terminal,  or  interactive  mode. 

The  data  base  referred  to  throughout  this  paper 
is  the  user's  data  base  which  is  populated  by 
U*  A from  the  user  inputted  URL  statements. 

Any  HP A name  type  that  represents  some  form  of 
data.  SETS,  INPUT? , OUTPUTS,  ENTITIES,  GFOUPS 
and  ELEMENT?  are  all  data  objects  described  by 
URL. 

• 

Any  leqal  file  or  device  name.  Allowable  names 
are  dependent  on  the  operating  system  being 
used. 

Any  legal  temporary  or  permanent  file  name  that 
is  to  be  specified  by  the  user. 

Any  temporary  or  permanent  tile  which  contains 
data  to  be  used  by  UFA  commands  via  INPUT  or 
FIL?  parameters. 

Synonym  to  "problem  statement."  Set  of 
requirements  fcr  a new  system. 


The  process  of  specifying  a problem  statement 
for  any  particular  system. 
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commands 

Multics  Command 

Multics  Command 
Language 

name  type 

physical  system 
design 


physical  system 
designer 


problem  definer 


problem 

statement 


prompt 


PUNCH  file 


report  commands 


segment 
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Commands  which  modify  the  contents  of  a UFA 
data  hase  in  the  manner  specified  by  the  user. 

A command  to  the  Multics  system;  an  element  of 
the  Multics  command  language. 

The  set  of  commands,  subcommands  and 
operands  recogni7ed  by  the  lultics  Operating 
System . 

Any  of  the  many  types  of  names  allowed  by  UFL 
(i.e.,  FF.OCESS,  S£T,  CROUP,  etc.).  Set  "The 
User  Requirements  Language,  Language  Reference 
Manual”1,  Appendix  F,  for  a list  of  all 
possible  name  types. 


The  process  of  specifying  a physical 
system  (consisting  of  software,  machinery, 
etc.)  given  a particular  ptoblem  statement. 

Person  responsible  for  deriving  a 
physical  system  design  from  the  problem 
statement  generated  from  the  lcqical  system 
design  process. 

Used  synonymously  with  "analyst,''  That  person 
who  develops  the  requirements  stated  by  the 
users  into  a format  understandable  by  others 
and  in  sufficient  detail  to  be  usable  by  the 
physical  system  designer.  The  product  of  his 
work  is  the  problem  statement. 

A set  of  requirements  specified  by  users  of  a 
proposed  system  and  expressed  by  the  problem 
definer  into  a format  acceptable  by  the 
organi7ation. 

A system  function  that,  requests  the  terminal 
user  to  supply  operands  necessary  to  continue 

process i ng . 

A tile  which  contains  data  (usually  UFL 
user-names)  in  a format  that  can  be  used  as 
input  to  one  or  more  UFA  commands. 

Those  commands  which  retrieve  data  from  a UFA 
data  base  and  output  it  in  some  meaningful 
format. 

A named  collection  of  data  which  is  accessible 
by  ♦he  system.  The  data  set  usually  resides  on 


USer ' s 


Manual . 
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term 


undefined  name 


UP  A 


UP  A command 


URA  data  base 


UFL 


URL  statement 


user- name 
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an  auniliary  storage  device. 

Identifier  to  designate  that  the  teimip').  is  t 
he  used  as  a source  of  inpu*  ct  moa  fot 
out  put . 

A name  of  a UFL  ob-ject.  that  has  been  en‘e:od 
into  the  UFA  data  base,  but  has  no  name  type 
associated  with  it. 

The  User  Fequirements  Analyzer.  A sof  t ...  i 
package  which  stores  information  ir  the  UFA 
data  hase  by  interprett  ing  UFL  st.atemer* 
as  input,  and  retrieves  information  t:  >r, 
data  base  in  the  fcrm  oi  reports. 

Any  of  the  commands  that  can  be  us< 

URA.  *?ee  "User  Fequirements  Analyz  t iv.n.i 
Descriptions”1  for  complete  description,  a bo.  t 
each  command  available  in  URA. 

File  where  UFL  information  is  stored  {in  a 
coded  format)  which  can  then  be  accessed  t'  ► ' 
user. 

The  User  Requirements  Language.  The  collect aot 
of  all  URL  statements  allowed  Col  use  bv  Ft 
See  "The  User  Requirements  Language,  Lai 
Reference  tlanual"*  for  complete  description. 

A statement  specified  by  ”The  User  Fequirements 
Language,  Lanquage  Reference  Manual". * Each 
statement  may  define  a UFL  object,  define 
comment  entry,  or  define  a relationship  .nswng 
two  or  more  UFL  objects. 

Any  legal  UFL  name  specified  by  problem 
definor.  Also  called  a "user  defined  name". 
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11 

r 


I 

I 

■ 


I 


» 


ji 
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The  attached  lis»  gives  tor  each  ASCII  character  a code  of  * t 
4 classifying  the  characters  into  the  following  catcqoi 1 *: 

Colo  1:  Nonprinting  operatinq  Sy^tet  «iul  t rane-n.  * 
control  characters  to  ho  treated  as  punctuation,  hut  *ill  lvv 
ho  illegal. 

Cod*'  2:  Puneutation,  delimiters,  etc.  which  are  no* 
allowed  in  names. 

Codo  3:  Characters  allowed  a*  any  position  it;  a nsn . 

Colt*  4;  Characters  allowed  at  any  position  > r.  a r,.u 
the  first. 

There  are  three  versions  cf  this  categorisation 

1.  A one  page  summary. 

2.  Sorted  bv  Octal  representation. 

Sorted  by  code,  then  by  Octal  representation. 
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CODE  1;  All  others 

CODE  2:  "R»  (!*,:;*?[  ]|- 

CO Df  3:  ABCDIFGHIJKLHNOPCPSTUVWXY2 

abcdof  qh i jklenopqrst  uvwxy? 

• () 

> 

CODE  4:  01234567b0 

♦-./<> 


I 
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cor? 

w 

CHAF 

NAME 

T 

nuT“ 

null  or  ti*e  till  char 

i 

301 

soh 

start  of  heading 

i 

('f*  2 

St  X 

start  of  text 

i 

25  3 

etx 

end  ot  text  (EOM) 

i 

p*  4 

oot 

end  of  transmission  (EO") 

i 

* j 5 

enq 

enquiry  (fciSU) 

i 

20ft 

ack 

acknowiedqe  (FU) 

i 

fj  7 

hel 

hell 

i 

C 10 

hs 

hack  spac« 

i 

011 

ht 

horizontal  tabulation  (TAB) 

i 

012 

if 

line  feed  (LINE  FEED) 

i 

"1  3 

vt 

vertical  tabulation  (VT) 

i 

? 1 4 

tf 

torn  feed  (FClh) 

i 

r'1  3 

cr 

carriage  return  (IETUEN) 

i 

016 

so 

shift  out 

i 

017 

si 

shift  in 

i 

C 2“ 

die 

data  link  escape 

i 

021 

del 

device  control  1 (X-ON) 

i 

:22 

dc2 

device  control  2 (TAPE) 

i 

02  3 

dc3 

device  control  3 (X-OFK) 

i 

024 

dc4 

device  control  4 ('"APE) 

i 

v25 

nak 

negative  ackr.ovledqp 

i 

02o 

syn 

synchronous  idle 

i 

i 27 

etb 

end  of  transmission  blocks 

i 

0 30 

can 

cancel 

i 

C 3 1 

Ol 

end  of  medium 

i 

032 

SS 

special  sequence 

i 

033 

esc 

esca pe 

i 

034 

fs 

file  separator 

i 

<’35 

qs 

qroup  separator 

i 

0 ? 6 

rs 

record  separator 

i 

0 37 

us 

unit  separator 
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CODE 

____ 

OCTAL 

~zzt~ 

£HAF 

sp 

J 

041 

» 

j 

042 

II 

043 

» 

3 

04  4 

f 

3 

045 

f 

2 

C46 

fi 

4. 

C47 

1 

3 

050 

( 

3 

051 

) 

2 

0^2 

* 

4 

0 53 

♦ 

2 

u 54 

f 

4 

055 

- 

4 

056 

• 

4 

0 57 

/ 

4 

0 60 

e 

4 

C 61 

1 

4 

u62 

2 

4 

< 63 

3 

4 

t o4 

4 

4 

06  5 

5 

4 

(66 

6 

4 

u67 

7 

4 

C 70 

8 

4 

C 7 1 

9 

2 

072 

■ 

2 

073 

• 

• 

4 

074 

< 

0 

4. 

075 

- 

4 

376 

> 

2 

C7  7 

7 

NA£E 

space  (SPACE  BAP) 

exclamation  point 

quotation  mark 

number  siqn 

currency  symbol 

percent 

ampersand 

a post  rophe 

opening  parenthesis 

closir.q  parenthesis 

asterisk 

plus 

comma 

hyphen  or  minus 

period 

slant 

zero 

one 

two 

three 

four 

five 

six 

seven 

eiqht 

nine 

colon 

semicolon 

less  than 

equa  1 

greater  than 
question  mark 
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W 

101 

102 

KJ 

104 

105 

106 
107 
110 
111 
112 

113 

114 
113 
116 
117 
12C 
121 
122 

123 

124 

125 
1 2t 
127 
1^0 

131 

132 

133 

134 

135 

136 

137 


CH*£ 

® co**ercial  at 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

I. 

M 

N 

0 

P 


Q 

F 

S 

T 

U 

V 

w 

X 

Y 
z 
t 
\ 
3 


openinq  bracket 
reverse  slant 
closing  bracket 
circuit  f lex 
underline 
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> 


» 


“§*  s^i 

3 141 

3 142 

3 143 

3 144 

3 145 

3 146 

3 147 

3 130 

J 131 

3 132 

3 133 

3 134 

3 135 

3 136 

3 137 

3 160 

3 161 

3 162 

3 163 

3 164 

3 165 

3 166 

3 167 

3 170 

3 171 

3 172 

2 173 

2 174 

2 175 

2 176 

1 177 


£HAI. 

\ 

a 

b 

c 

d 

e 

f 

g 

h 

i 

1 

k 

1 

m 

n 

0 
P 
•1 
r 
s 
t 
u 

V 

V 
X 

V 

7. 

( 

1 
) 

del 


MM 

qravo  accent 


openinq  brace 
vertical  line 
closinq  brace 
tilde 

delete  (RUBOUT) 


I 


( 
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c£ 

it- 

££Ai 

nul 

NAME 

null  or  time  fill  char 

001 

soh 

start  of  headinq 

00  2 

stx 

start  of  text 

00  3 

etx 

end  of  text  (EOM) 

004 

eot 

end  of  transmission  (ECT) 

0l.5 

enq 

enquiry  (HRU) 

C06 

ack 

acknowledqe  ( R tl) 

007 

bel 

hell 

010 

hs 

back  space 

01 1 

ht 

horizontal  tabul.it  ion  (TA 

012 

If 

line  feed  (LINE  FFET) 

01  3 

vt 

vertical  tabulation  (V?i 

0 1 4 

ff 

form  teed  (FCRK) 

013 

cr 

carriaqe  return  {^TURN) 

:i6 

so 

shift  out. 

('17 

si 

shift  in 

^ 2" 

die 

data  link  escape 

121 

del 

device  control  1 (X-ON) 

a 

. 4 *. 

dc2 

device  control  2 (TAPE) 

123 

dc3 

device  control  3 (X-OFF) 

v 24 

dc4 

device  control  4 (TAPF) 

:-2* 

nak 

noqative  acknowledge 

0 2* 

syn 

synchronous  idle 

0 27 

etb 

end  ot  transmission  block 

a 30 

can 

cancel 

r31 

ein 

end  of  medium 

•3  3 2 

ss 

special  sequence 

0 3 3 

esc 

esca  pe 

0 34 

t s 

file  separator 

"35 

q.S 

qroup  separator 

036 

rs 

record  separator 

037 

us 

unit  separator 

177 

del 

delete  (FUBOim 

1 


1 
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£odi 

“HP 

sp 

NAME 

space  (SPACE  BAB) 

2 

042 

N 

quotation  nark 

2 

046 

& 

ampersand 

2 

047 

1 

apostrophe 

2 

050 

( 

opening  parenthesis 

2 

051 

) 

closinq  parenthesis 

2 

052 

* 

asterisk 

2 

054 

9 

coma 

2 

072 

• 

• 

colon 

2 

073 

• 

• 

seaicolon 

2 

075 

s 

equal 

2 

077 

? 

question  aark 

2 

133 

[ 

openinq  bracket 

2 

135 

] 

closinq  bracket 

2 

174 

1 

vertical  line 

2 

176 

-e 

tilde 

Appendix  I ASCII  Character  set  for  UFA 


UFA  Os«r's  lanual 


3 04  3 

J 044 

3 045 

3 100 

3 101 

3 1*2 

3 103 

3 104 

3 105 

3 106 

3 107 

3 110 

3 111 

3 112 

3 113 

3 114 

3 113 

3 116 

3 117 

3 12C 

3 121 

3 122 

3 123 

3 124 

3 125 

3 126 

3 127 

3 131 

3 131 

3 132 


HAJLfi 

inclination  point 
nuttb#r  sign 
currency  synbol 
p«rc«nt 
coanatcial  at 


c 

0 

B 

r 

6 

H 

Z 

J 

K 

L 

Jt 

N 

0 

P 

Q 

F 

S 

T 

U 

V 

V 
X 
1 
7. 
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£2^1 

W 

\ 

Jil£l 

roverse  slant 

3 

136 

circuaf lex 

3 

140 

\ 

grave  accent 

3 

141 

a 

3 

142 

b 

3 

143 

c 

3 

144 

d 

3 

145 

e 

3 

146 

f 

3 

147 

4 

3 

130 

h 

3 

131 

1 

3 

132 

1 

3 

133 

k 

3 

134 

1 

3 

135 

n 

3 

136 

n 

3 

137 

o 

3 

160 

P 

3 

161 

q 

3 

162 

r 

3 

163 

s 

3 

164 

t 

3 

165 

u 

3 

166 

V 

3 

167 

V 

3 

170 

X 

3 

171 

Y 

3 

172 

z 

3 

173 

( 

opening  brace 

3 

175 

1 

closing  brace 

t 

I 
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CfiJI 

W 

SMI 

♦ 

HABE 

plus 

u 

055 

- 

hyphen  or  sinus 

4 

i 56 

• 

period 

4 

057 

/ 

slant 

4 

f 60 

0 

zero 

4 

061 

1 

one 

4 

062 

2 

t vo 

4 

06  3 

3 

three 

4 

v6  4 

4 

four 

4 

j65 

5 

five 

4 

066 

6 

six 

4 

067 

7 

seven 

4 

07'1 

8 

eiqht 

4 

071 

4 

nine 

4 

C 74 

< 

less  than 

4 

076 

> 

qreater  than 

4 

137 

underline 
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